RIrillet
Customers

Lists all customers

Changed on

Returns customers for accounts receivable with pagination and optional search or external-reference filters.

get/customers

Request

Query parameters

limitinteger

Maximum number of rows to return in the page.

cursorstring

If defined, a cursor to retrieve the next page.

Example:iLQvkEj3sh3UiweC

Pagination cursor to navigate through the full response.

searchstring

Filter customer by name.

external_reference_idstring

If this is provided, external_reference_type must also be provided.

external_reference_typestring

If this is provided, external_reference_id must also be provided.

updated.gtstring date-time
Example:2023-01-01T00:00:00Z

Filter customers updated after this timestamp

sort_by'created' | 'updated'

the field the customers should be sorted by descending (either created or updated)

Response

OK

Example response

{
  "customers": [
    {
      "name": "Bob",
      "name_on_invoice": "Bob Johnson",
      "address": {
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "city": "Nashville",
        "state": "TN",
        "zip_code": "37201",
        "country": "US"
      },
      "shipping_address": {
        "line1": "123 Main St",
        "line2": "Apt 4B",
        "city": "Nashville",
        "state": "TN",
        "zip_code": "37201",
        "country": "US"
      },
      "billing_addresses": [
        {
          "line1": "123 Main St",
          "line2": "Apt 4B",
          "city": "Nashville",
          "state": "TN",
          "zip_code": "37201",
          "country": "US"
        }
      ],
      "shipping_addresses": [
        {
          "line1": "123 Main St",
          "line2": "Apt 4B",
          "city": "Nashville",
          "state": "TN",
          "zip_code": "37201",
          "country": "US"
        }
      ],
      "emails": [
        {
          "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
          "email": "bobjohnson@somedomain.com"
        }
      ],
      "external_references": [
        {
          "type": "xyzSystemId",
          "id": "234",
          "url": "https://xyzsystempage.com/ids/234"
        }
      ],
      "tax_ids": [
        {
          "value": "DE123456789"
        }
      ]
    }
  ],
  "pagination": {
    "next_cursor": "iLQvkEj3sh3UiweC"
  }
}

Changes

  • c393d0102005Revision changes
    • breaking

      the ////// response's property type changed from object to no type for status

    • breaking

      the ////// response's property type changed from object to no type for status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property //////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added to the ////// response property allOf list for the response status

    • info

      added to the ////// response property allOf list for the response status

    • info

      response property customers/items/allOf[CustomerRequest]/address deprecated

    • info

      response property customers/items/allOf[CustomerRequest]/shipping_address deprecated