List Catalog Items
Lists catalog items for the authenticated merchant, including current HSA/FSA eligibility for each item.
This endpoint is intended to complement the `Item Eligibility Updated` webhook: use the webhook to receive ongoing updates, and use this endpoint to enumerate items that were already categorized before webhook ingestion began (or to reconcile after a gap).
Use `eligibility` to scope the response to a specific eligibility state, and `updated_after` to incrementally sync only items changed since the last poll.
Authentication
x-truemed-api-keystring
Sales channel API key for merchant server-to-server authentication
Query parameters
page
Optional field indicating which page to access. Defaults to 1.
page_size
Optional field indicating the number of records per page. Defaults to 30.
eligibility
Filter results to items whose eligibility matches the given value. Items that have not been reviewed yet are excluded when this filter is set.
updated_after
Return only catalog items whose last update is at or after this ISO 8601 timestamp. Useful for incremental sync after Item Eligibility Updated webhooks.
Response
Successful response
data
An array of catalog item objects for the current page.
pagination
A pagination object with information about the current page, page size, total count, and last page.
Errors
400
Bad Request Error
404
Not Found Error
405
Method Not Allowed Error
500
Internal Server Error
501
Not Implemented Error