---
title: "The objects of one type a consumer's sync handled"
method: GET
path: "/consumers/{consumer_id}/syncs/{syncid}/objects/{kind}"
tags: ["Syncs"]
---

# The objects of one type a consumer's sync handled

`GET /consumers/{consumer_id}/syncs/{syncid}/objects/{kind}`

## Request

- Base URL: `https://api.chift.eu`
- URL: `https://api.chift.eu/consumers/{consumer_id}/syncs/{syncid}/objects/{kind}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chift/apis/chift-api/docs/consumers/:consumer_id/syncs/:syncid/objects/:kind/get.ts> (a function with typed inputs; its response is checked against the schema)

One page of them, the latest changed first. `kind` is the object's type, e.g. `supplier_invoice`; read one with `GET …/objects/{kind}/{object_id}`.

## Path parameters

- `consumer_id` string, uuid, required
- `syncid` string, uuid, required
- `kind` string, required

## Query parameters

- `status` string, nullable: Only the objects in this status, e.g. 'failed'.
- `search` string, nullable: Only the objects whose source or target id contains it.
- `page` integer
- `size` integer

## Response `200`

Successful Response

- ChiftPageObjectItem
  - `items` ObjectItem[], required
    - `id` string, uuid, required: The object's id: read it with `GET …/objects/{kind}/{id}`.
    - `kind` string, required: The object's type, e.g. 'supplier_invoice'.
    - `capability` string, required: Key of the capability that handles it.
    - `source_id` string, required: Its id in the source.
    - `scope` object, required: What identifies it beside its source id, for a sync keying its objects on something the consumer runs several of: `{"location_id": "paris"}`. Empty otherwise.
    - `status` string, required: Where it stands, e.g. 'pending', 'success', 'failed', 'skipped', 'never_retry'.
    - `target_id` string, nullable, required: What it was booked as in the target. Null until then.
    - `booked_as` string, nullable, required: Key of the mode that booked it.
    - `attempts` integer, required: How many times it failed.
    - `last_error_code` string, nullable, required: The code of its last failure.
    - `created_at` string, date-time, required: When the sync first saw it.
    - `updated_at` string, date-time, required: When it last changed.
    - `succeeded_at` string, date-time, nullable, required: When it was booked.
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `404`: Not Found
- `422`: Validation Error

## Changes

- **2026-11-03** `020884969534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chift/apis/chift-api/changes/consumers/:consumer_id/syncs/:syncid/objects/:kind/get.md)

---

[API](https://skmtc.dev/chift/apis/chift-api.md) - [All operations](https://skmtc.dev/chift/apis/chift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chift/apis/chift-api/revisions/020884969534?raw)