Jupiter ERP
Account API

List projects

/api/account/projects

GETHTTP
get/api/account/projects

Beispielanfrage

GET https://api.jupiter-erp.com/api/account/projects

Code
curl -X GET 'https://api.jupiter-erp.com/api/account/projects' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'X-Account-Uuid: YOUR_ACCOUNT_UUID' \
  -H 'Accept: application/json'

Parameter

NameInPflichtBeschreibung
searchqueryneinSearch in project number and name (Bezeichnung). Supports SQL-like syntax: `test*`, `*test`, `*test*`, `test`.
namequeryneinFilter by project name only. Supports SQL-like syntax: `test*`, `*test`, `*test*`, `test`.
statusquerynein
contact_idquerynein
account_user_idquerynein
order_byqueryneinSort by a specific field
#/components/parameters/OrderDirParameter
#/components/parameters/PerPageParameter
#/components/parameters/PageParameter

Antworten

200OK
FeldTypBeschreibung
data*object[]

array

Elemente

FeldTypBeschreibung
account_userobject
FeldTypBeschreibung
abilitiesstring[]Ability strings for this account user. Included when listing or getting users (admin editing). Omitted in embedded contexts (e.g. documents, projects, service orders) to avoid leaking permission data.

array

Elemente

string

created_atstring (date-time)Creation timestamp in ISO 8601 format.
display_emailstring
display_namestring
display_phonestring
id*integer
invited_emailstringEmail address the user was invited with. Set for pending account users; null after acceptance or when not applicable.
role*string

string

  • user
  • admin
status*string

string

  • active
  • blocked
  • pending
updated_atstring (date-time)Last update timestamp in ISO 8601 format.
userobject
FeldTypBeschreibung
email*string
id*integer
image_urlstring
name*string
account_user_idinteger
contactobject
FeldTypBeschreibung
additional_namestring
address_line_1stringFirst line of the address (Street and House number)
address_line_2stringSecond line of the address
avatarobject
FeldTypBeschreibung
idinteger
urlstring
bank_bicstringBank BIC/SWIFT code
bank_ibanstringBank IBAN
birthdatestring (date)Birthdate of the contact in ISO 8601 format.
buyer_referencestring
cash_discount_daysintegerCash discount days for the contact.
cash_discount_ratenumber (float)Cash discount percentage for the contact.
citystringCity of the address.
company_namestringCompany name (used as name_line_3 in document addresses).
contact_numberinteger
country_codestringISO country code of the address.
created_atstring (date-time)Creation timestamp in ISO 8601 format.
creditor_numberinteger
custom_dataobject
customer_discount_ratenumber (float)Customer-specific discount percentage.
debtor_numberinteger
delivery_termsstring
emailsobject[]

array

Elemente

FeldTypBeschreibung
namestring
valuestring (email)
fieldsobject[]List of contact field values

array

Elemente

FeldTypBeschreibung
id*integerField ID
key*stringField key
value*objectValue of the field
first_namestring
genderstring

string

  • female
  • male
  • diverse
group_idsinteger[]

array

Elemente

integer

groupsobject[]List of groups associated with the contact.

array

Elemente

FeldTypBeschreibung
id*integerUnique identifier for the group.
name*stringName of the group.
id*integer
internal_notestringHTML
is_organisation*boolean
last_namestring
name*string
parentobject
FeldTypBeschreibung
additional_namestring
address_line_1stringFirst line of the address (Street and House number)
address_line_2stringSecond line of the address
bank_bicstringBank BIC/SWIFT code
bank_ibanstringBank IBAN
birthdatestring (date)Birthdate of the contact in ISO 8601 format.
buyer_referencestring
cash_discount_daysintegerCash discount days for the contact.
cash_discount_ratenumber (float)Cash discount percentage for the contact.
citystringCity of the address.
company_namestringCompany name (used as name_line_3 in document addresses).
contact_numberinteger
country_codestringISO country code of the address.
created_atstring (date-time)Creation timestamp in ISO 8601 format.
creditor_numberinteger
custom_dataobject
customer_discount_ratenumber (float)Customer-specific discount percentage.
debtor_numberinteger
delivery_termsstring
emailsobject[]

array

Elemente

FeldTypBeschreibung
namestring
valuestring (email)
first_namestring
genderstring

string

  • female
  • male
  • diverse
id*integer
internal_notestringHTML
is_organisation*boolean
last_namestring
name*string
parent_idinteger
payment_term_daysinteger
payment_termsstring
phonesobject[]

array

Elemente

FeldTypBeschreibung
namestring
valuestringPhone number in E.164 format.
positionstringPosition of the contact in the organisation.
quote_due_daysinteger
reference_keystring
sepa_creditor_idstring
statestringState or region of the address.
tax_idstringTax ID
titlestringTitle of the contact (e.g., Mr., Mrs.).
type*string

string

  • organisation
  • person
updated_atstring (date-time)Last update timestamp in ISO 8601 format.
vat_idstringVAT ID
websitesobject[]

array

Elemente

FeldTypBeschreibung
namestring
valuestring (https://test.com)
zipstringZIP or postal code.
parent_idinteger
payment_term_daysinteger
payment_termsstring
phonesobject[]

array

Elemente

FeldTypBeschreibung
namestring
valuestringPhone number in E.164 format.
positionstringPosition of the contact in the organisation.
quote_due_daysinteger
reference_keystring
sepa_creditor_idstring
statestringState or region of the address.
status*stringContact lifecycle status. List endpoints default to active contacts when omitted.

string

  • active
  • archived
tax_idstringTax ID
titlestringTitle of the contact (e.g., Mr., Mrs.).
type*string

string

  • organisation
  • person
updated_atstring (date-time)Last update timestamp in ISO 8601 format.
vat_idstringVAT ID
websitesobject[]

array

Elemente

FeldTypBeschreibung
namestring
valuestring (https://test.com)
zipstringZIP or postal code.
contact_idinteger
created_atstring (date-time)Creation timestamp in ISO 8601 format.
descriptionstring
end_datestring
formatted_number*stringDisplay number (account format), unique per account
hex_colorstring
id*integer
name*string
number*integerSequential project number per account (internal)
start_datestring
statusstring
updated_atstring (date-time)Last update timestamp in ISO 8601 format.
meta*object
FeldTypBeschreibung
current_page*integerThe current page number.
items_from*integerThe starting item number on the current page.
items_to*integerThe ending item number on the current page.
last_page*integerThe last page number.
per_page*integerThe number of items per page.
total*integerThe total number of items.
Beispiel Response
{
  "data": [
    {
      "id": 0,
      "number": 0,
      "formatted_number": "string",
      "name": "string",
      "hex_color": "string",
      "description": "string"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "items_from": 1,
    "items_to": 1
  }
}
Projects

Fragen zur Integration?

GET /api/account/projects · Jupiter ERP