DemandFlow Support Centre

API: GET /v1/objects/{id}. Read an object

ReferenceAPI Reference16/04/2026Updated 16/04/2026
Fetch a single object by its id. Returns the full record as JSON, or a 404 if it does not exist in your subscription.

GET /v1/objects/{id}

Fetches a single object by its id, scoped to your subscription.

Path parameters

  • id, the object's UUID.

Query parameters

  • entity (optional), uppercase entity code. Hinting the entity lets the API route the read directly without an extra lookup. Safe to omit in almost all cases.

Responses

  • 200. JSON object with all fields on the record.
  • 404, object not found (either the id does not exist, or it belongs to another tenant).

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://rest.demandflow.com/v1/objects/a1b2c3d4-e5f6-4890-abcd-ef1234567890"

Returns something like:

{
  "id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
  "entity": "PPL",
  "level": 220,
  "comboKey": "SUB:...|ENT:a8da263a-...",
  "name": "Ada Lovelace",
  "_df_version": 4,
  "created": 1776336000000,
  "updated": 1776338516765,
  ...
}

See also

apigetreadobjectfetchby id

Was this article helpful?

← Back to Knowledge Base