v1

latestOpenAPI 3.1.02026-08-0452419.0 KB
purchases

List purchases

List purchases visible to the authenticated tenant, ordered by purchased_at descending. Use cursor pagination via since and limit.

get/purchases

Query parameters

member_idstring

Filter purchases to a single member.

plan_idstring

Filter purchases to a single plan. Must be one of the plans the token is authorized for; otherwise the API returns 403 Forbidden.

ndcstring

Filter to a single NDC-11 drug code.

prescriber_spistring

Filter to purchases written by a specific prescriber (Surescripts SPI).

event_type'claim' | 'reversal' | 'adjustment' | 'hra_initial_load' | 'hra_rollover' | 'hra_incentive'

Filter purchases to a single event type (e.g., only reversals).

status'accepted' | 'rejected' | 'pended' | 'reversed'

Filter purchases by processing status (e.g., only rejected).

sincestring

Cursor or ISO 8601 UTC timestamp. Returns purchases after this point.

untilstring date-time

ISO 8601 UTC timestamp upper bound (exclusive).

limitinteger

Max results per page.

Headers

Authorizationstring required

Production machine-to-machine flow. Tokens issued by Descope.

Response

A page of purchases.

next_cursorstring nullable required

Pass as since to fetch the next page. Null when no more pages.

All 5 operations