TLtlmtr
Catalog

Get catalog snapshot diff.

Changed on

Credits keys: 0.001 credits per successful metadata read; no recalculation.

Retrieve a stored diff's source snapshot ID, added and removed channel counts, creation time, and expiration time. Use List diff changes to retrieve channel IDs. Reading a diff does not recompute it. An unavailable diff returns 404; a retained but expired diff returns 410. Catalog and snapshot access must both be enabled.

get/v1/catalog/diffs/{diff_id}

Request

Path parameters

diff_idstring required

Unique diff identifier. Pass the value returned when creating or listing diffs unchanged.

Response

diff_idstring required

Unique diff identifier. Pass it unchanged to diff endpoints.

snapshot_idstring required

Unique identifier of the original snapshot. Pass it unchanged to snapshot endpoints.

added_countinteger required

Channels matching at diff creation that were absent from the original snapshot.

removed_countinteger required

Channels in the original snapshot that no longer matched at diff creation. This does not necessarily mean deletion from Telegram.

created_atstring required

Creation timestamp in UTC, formatted as RFC 3339.

expires_atstring required

Expiration timestamp in UTC, formatted as RFC 3339. Resources expire 30 days after their own creation.

Example response

{
  "diff_id": "01900000-0000-7000-8000-000000000002",
  "snapshot_id": "01900000-0000-7000-8000-000000000001",
  "added_count": 25,
  "removed_count": 10,
  "created_at": "2026-09-08T12:00:00Z",
  "expires_at": "2026-10-08T12:00:00Z"
}

Changes

  • 6c2bfd66c5f2Revision changes
    • breaking

      the response's body 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

    • info

      added subschema #2 to the response body allOf list for the response status

  • 80951ad7b3fbRevision changes
    • info

      endpoint added