Skip to main content
GET
/
v1
/
sync
/
get_receipts
Get receipts (synchronous)
curl --request GET \
  --url https://query.emergedata.ai/v1/sync/get_receipts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "user_id": "psub_d4e5f6789012345678901234abcdef01",
      "event_id": 502938,
      "timestamp": "2026-02-09T11:10:11Z",
      "ingested_at": "2026-02-09T11:12:00Z",
      "subject": "Your receipt from Nike",
      "retailer_name": "Nike",
      "receipt_currency": "USD",
      "total_value": 129.99,
      "items": [
        {
          "name": "Nike Pegasus 42",
          "quantity": 1,
          "price": 129.99,
          "brand": "Nike",
          "category": "/Shopping/Apparel/Footwear"
        }
      ],
      "category": "/Shopping/Apparel/Footwear",
      "brands": [
        "Nike"
      ]
    }
  ],
  "count": 1,
  "next_cursor": null,
  "has_more": false,
  "applied_ingested_end": "2026-02-12T09:10:11Z"
}

Authorizations

​
Authorization
string
header
required

API token from the Control Room. Include as Authorization: Bearer <token>

Query Parameters

​
begin
string<date-time> | null

Filter by event timestamp (start)

​
end
string<date-time> | null

Filter by event timestamp (end)

​
ingested_begin
string<date-time> | null

Filter by ingestion timestamp (start)

​
ingested_end
string<date-time> | null

Filter by ingestion timestamp (end), defaults to now()

​
uid
string
required

Your user reference

Example:

"alice@yourcompany.com"

​
category
string | null

Category subtree to filter by

Example:

"/Shopping"

​
limit
integer
default:1000

Maximum number of rows to return

Required range: 1 <= x <= 10000
​
cursor
string | null

Pagination cursor from previous response

Response

Successful Response

​
data
ReceiptsEvent · object[]
​
count
integer
​
next_cursor
string | null
​
has_more
boolean
​
applied_ingested_end
string<date-time> | null