Installer.com Docs
GET
/api/v1/order

List your orders, newest first. Filter by displayId (the job id shown in the app), externalId, idempotencyKey or email to find an order by a reference you hold, or page through all orders with cursor to match them on your side. Keep the same filters while paging. Unknown query parameters are rejected. Test orders are left out.

Authorization

Bearer
headerAuthorizationBearer <token>

Installer.com auth token

Query Parameters

displayId?string

Case-insensitive match on the job id shown in the app

Length1 <= length
externalId?string
Length1 <= length
idempotencyKey?string

The idempotency key sent when the order was created

Length1 <= length
email?string

Case-insensitive match on the customer email

Length1 <= length
updatedAfter?string

Only orders updated at or after this time. Use it to sync changes since your last poll.

Formatdate-time
limit?integer
Range1 <= value <= 100
Default25
cursor?string

nextCursor from the previous page

Length1 <= length

Response Body

Page of orders

application/json
  1. response
values*array<>
nextCursor*|

Pass as cursor to get the next page. Null on the last page.

Example Request
curl -X GET 'https://api.installer.com/api/v1/order'
Example Response
{  "values": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "displayId": "string",      "externalId": "string",      "name": "string",      "description": "string",      "status": "PENDING",      "source": "API",      "isTest": true,      "contactPersonName": "string",      "email": "string",      "phoneNumber": "string",      "address": "string",      "postalCode": "string",      "city": "string",      "state": "string",      "countryCode": "string",      "tags": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "color": "string",          "date": "string"        }      ],      "customFields": {        "property1": "string",        "property2": "string"      },      "metadata": {        "property1": null,        "property2": null      },      "workflow": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",        "templateCustomId": "string",        "templateName": "string",        "templateVersion": 0,        "actors": [          {            "slug": "string",            "name": "string",            "organization": {              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",              "name": "string",              "externalId": "string"            }          }        ],        "steps": [          {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "templateStepId": "2a465857-77fb-4953-99f7-90a658d82eec",            "title": "string",            "type": "booking_create",            "status": "todo",            "completedAt": "2019-08-24T14:15:22Z",            "actorSlug": "string",            "assignee": {              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",              "name": "string",              "email": "string"            }          }        ]      },      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "closedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}