External lookup endpoints

Get a lookup record by its ID

get

Retrieves a single lookup record using its unique identifier.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

recordIdstringRequired

Responses

200

Successfully retrieved the lookup record.

application/json

LookupRecord

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequired

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

versionnumberRequired

The version of the record.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

get

/api/lookuprecords/{recordId}

HTTPcURLJavaScriptPython

GET /api/lookuprecords/{recordId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "attributeDefinitions": {},
  "created": "2026-03-02T22:54:08.393Z",
  "id": "text",
  "items": [
    {
      "id": "text",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-03-02T22:54:08.393Z",
  "tenantRecordId": "text",
  "version": 1
}

Updates a whole lookup record by its ID

put

Updates a single lookup record.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

recordIdstringRequired

Body

application/json

LookupRecordForUpdate

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

versionnumberRequired

The version of the record.

Responses

200

Successfully updated the lookup record.

application/json

LookupRecord

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequired

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

versionnumberRequired

The version of the record.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

put

/api/lookuprecords/{recordId}

HTTPcURLJavaScriptPython

PUT /api/lookuprecords/{recordId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "attributeDefinitions": {},
  "items": [
    {
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "tenantRecordId": "text",
  "version": 1
}

{
  "attributeDefinitions": {},
  "created": "2026-03-02T22:54:08.393Z",
  "id": "text",
  "items": [
    {
      "id": "text",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-03-02T22:54:08.393Z",
  "tenantRecordId": "text",
  "version": 1
}

Get all lookup records

get

Retrieves all lookup records.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successfully retrieved the lookup records.

application/json

LookupRecord

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequired

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

versionnumberRequired

The version of the record.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

get

/api/lookuprecords

HTTPcURLJavaScriptPython

GET /api/lookuprecords HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "attributeDefinitions": {},
  "created": "2026-03-02T22:54:08.393Z",
  "id": "text",
  "items": [
    {
      "id": "text",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-03-02T22:54:08.393Z",
  "tenantRecordId": "text",
  "version": 1
}

Create a lookup record by its ID

post

Creates a single lookup record.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

LookupRecordForCreation

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

Responses

200

Successfully created the lookup record.

application/json

LookupRecord

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequired

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

versionnumberRequired

The version of the record.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

post

/api/lookuprecords

HTTPcURLJavaScriptPython

POST /api/lookuprecords HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "attributeDefinitions": {},
  "items": [
    {
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "tenantRecordId": "text"
}

{
  "attributeDefinitions": {},
  "created": "2026-03-02T22:54:08.393Z",
  "id": "text",
  "items": [
    {
      "id": "text",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-03-02T22:54:08.393Z",
  "tenantRecordId": "text",
  "version": 1
}

Delete a lookup record by its ID

delete

Deletes a single lookup record using its unique identifier.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

recordIdstringRequired

Responses

200

Successfully deleted the lookup record.

application/json

LookupRecord

attributeDefinitionsall ofRequired

Map of attribute definitions that specify the type for each attribute.

object · LookupAttributeDefinitionsOptional

LookupAttributeDefinitions

createdstring · date-timeOptional

The date when the record was created.

idstringRequired

lastModifiedstring · date-timeOptional

The date when the record was last modified.

tenantRecordIdstring · min: 1 · max: 20Optional

Tenant-specific identifier for the lookup record.

versionnumberRequired

The version of the record.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

delete

/api/lookuprecords/{recordId}

HTTPcURLJavaScriptPython

DELETE /api/lookuprecords/{recordId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "attributeDefinitions": {},
  "created": "2026-03-02T22:54:08.393Z",
  "id": "text",
  "items": [
    {
      "id": "text",
      "values": [
        {
          "attributeId": "text",
          "attributeValue": "text"
        }
      ]
    }
  ],
  "lastModified": "2026-03-02T22:54:08.393Z",
  "tenantRecordId": "text",
  "version": 1
}

List all record items (search cached for 5 minutes)

post

This part of the API is in Beta status. For details please check the api-release-life-cycle documentation. Search for LookupRecordItem

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

LookupRecordItemSearchPayload

afterstringOptional

The cursor to start after for forward pagination. The value is provided in the pageInfo.endCursor field of the response. Cannot be used with before or last.

beforestringOptional

The cursor to start before for backward pagination. The value is provided in the pageInfo.startCursor field of the response. Cannot be used with after or size (first).

lastnumber · min: 1 · max: 250Optional

Number of items to return for backward pagination. Cannot be used with 'size' (first). Default: 20.

sizenumber · min: 1 · max: 250Optional

Number of items to return for forward pagination. Cannot be used with 'last'. Default: 20.

startAfterIdstringOptionalDeprecated

The ID to start after. Deprecated, use after with the value provided in pageInfo.endCursor instead.

Responses

200

Your search result

application/json

LookupRecordItemPaginatedResult

totalnumberOptional

The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

post

/api/lookuprecorditems/search

HTTPcURLJavaScriptPython

POST /api/lookuprecorditems/search HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2243

{
  "after": "text",
  "before": "text",
  "last": 1,
  "options": {
    "withTotal": true
  },
  "query": {
    "and": [
      {
        "and": [
          {
            "and": "[Circular Reference]",
            "id": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "or": "[Circular Reference]",
            "recordRef": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "tenantRecordId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "values": {
              "contains": {
                "attributeId": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                },
                "attributeValue": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "id": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "or": [
          {
            "and": "[Circular Reference]",
            "id": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "or": "[Circular Reference]",
            "recordRef": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "tenantRecordId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "values": {
              "contains": {
                "attributeId": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                },
                "attributeValue": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "recordRef": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "tenantRecordId": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "values": {
          "contains": {
            "attributeId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "attributeValue": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "id": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "or": [
      {
        "and": "[Circular Reference]",
        "id": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "or": "[Circular Reference]",
        "recordRef": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "tenantRecordId": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "values": {
          "contains": {
            "attributeId": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "attributeValue": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "recordRef": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "tenantRecordId": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "values": {
      "contains": {
        "attributeId": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "attributeValue": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        }
      }
    }
  },
  "size": 1
}

{
  "lookupRecordItems": [
    {
      "id": "text",
      "recordRef": "text",
      "tenantRecordId": "text",
      "values": {
        "attributeId": "text",
        "attributeValue": "text"
      }
    }
  ],
  "pageInfo": {
    "endCursor": "text",
    "hasNextPage": true,
    "hasPreviousPage": true,
    "startCursor": "text"
  },
  "total": 1
}