Skip to main content
GET
/
api
/
v1
/
{app_id}
/
organisations
Error
A valid request URL is required to generate request examples
{
  "companies": [
    {
      "app_id": "<string>",
      "attributes": [
        {
          "description": "<string>",
          "id": "<string>",
          "key": "<string>",
          "name": "<string>",
          "template_key": "<string>",
          "translations": {
            "description": {},
            "name": {}
          },
          "values": {}
        }
      ],
      "billing_address": [
        {
          "city": "<string>",
          "co_address": "<string>",
          "company_id": "<string>",
          "company_name": "<string>",
          "country": "<string>",
          "created_at": "<string>",
          "house_number": "<string>",
          "id": "<string>",
          "is_default": true,
          "name": "<string>",
          "phone": "<string>",
          "postal_code": "<string>",
          "shipping_type": "<string>",
          "state_province": "<string>",
          "street_address": "<string>",
          "updated_at": "<string>"
        }
      ],
      "contact_name": "<string>",
      "created_at": "<string>",
      "credit_check": true,
      "custom_fields": {},
      "email": "<string>",
      "external_ref": "<string>",
      "files": [
        {
          "app_id": "<string>",
          "content_type": "<string>",
          "created_at": "<string>",
          "custom_fields": {},
          "filename": "<string>",
          "id": "<string>",
          "updated_at": "<string>",
          "url": "<string>"
        }
      ],
      "id": "<string>",
      "invoice_email": "<string>",
      "level": "<string>",
      "name": "<string>",
      "organisation_number": "<string>",
      "phone": "<string>",
      "role": "<string>",
      "shipping_address": [
        {
          "city": "<string>",
          "co_address": "<string>",
          "company_id": "<string>",
          "company_name": "<string>",
          "country": "<string>",
          "created_at": "<string>",
          "house_number": "<string>",
          "id": "<string>",
          "is_default": true,
          "name": "<string>",
          "phone": "<string>",
          "postal_code": "<string>",
          "shipping_type": "<string>",
          "state_province": "<string>",
          "street_address": "<string>",
          "updated_at": "<string>"
        }
      ],
      "status": "<string>",
      "store_groups": [
        {
          "country_of_sale": "<string>",
          "created_at": "<string>",
          "description": "<string>",
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "store_type": "<string>",
          "updated_at": "<string>"
        }
      ],
      "tags": [
        {
          "id": "<string>",
          "key": "<string>",
          "name": "<string>"
        }
      ],
      "tax_id_vat_number": "<string>",
      "updated_at": "<string>"
    }
  ],
  "page": 123,
  "total": 123,
  "total_pages": 123
}

Path Parameters

app_id
string
required

UUID of the app

Query Parameters

page
integer

Page number for pagination. If not provided, all organisations are returned.

per_page
integer

Number of items per page. Max 20. If not provided, all organisations are returned.

Search query for organisation name and number

Response

OK

companies
object[]
page
integer
total
integer
total_pages
integer