Partner API

DayBlink Select read-only vendor catalog for partner integrations. Production and sandbox share the same methods, paths, query parameters, and error envelope. Only the base path, token, and data differ.

This is a hosted Partner API. Partners call the production host below.

Host	URL	Use
Production	`https://dayblinkselect-api-service-git-main-day-blink-gpo.vercel.app`	Live vendor catalog
Custom domain	`https://api.dayblinkselect.com`	Same service after DNS is attached

Production catalog is /v1 with Bearer fp_live_... from Select API Access. Sandbox is the same host under /sandbox/v1 with the published token on /sandbox.

Partner endpoints

Production and sandbox use the same method, path suffix, query parameters, and JSON. Prefix production with /v1 and sandbox with /sandbox/v1. Catalog calls need Authorization: Bearer — production fp_live_... from Select API Access, sandbox fp_test_... published on /sandbox.

Public

Method	Production	Sandbox	Auth	What it returns
`GET`	`/health`	—	None	Liveness check. Returns { ok: true }.
`GET`	`/openapi.json`	—	None	OpenAPI 3.0 contract for this host.

Catalog

Method	Production	Sandbox	Auth	What it returns
`GET`	`/v1/taxonomy`	`/sandbox/v1/taxonomy`	Bearer	Categories, subcategories, spend areas, and enabled regions. Use these ids as filters on vendors.
`GET`	`/v1/vendors`	`/sandbox/v1/vendors`	Bearer	Paginated live listings. List items omit email and long-form HTML. Query: `page`, `perPage`, `q`, `vendor_id`, `category_id`, `subcategory_id`, `region_id`, `spend_area_id`, `country`
`GET`	`/v1/vendors/{id}`	`/sandbox/v1/vendors/{id}`	Bearer	One live vendor by UUID, including email and full_description. 404 if unknown or not live.

Rankings

Method	Production	Sandbox	Auth	What it returns
`GET`	`/v1/vendors/{id}/ranking`	`/sandbox/v1/vendors/{id}/ranking`	Bearer	Full score breakdown plus global rank_number for that live vendor.
`GET`	`/v1/rankings`	`/sandbox/v1/rankings`	Bearer	Live vendors ordered by rank_number. Optional vendor_id returns that row only. Query: `page`, `perPage`, `vendor_id`
`GET`	`/v1/categories/{id}/rankings`	`/sandbox/v1/categories/{id}/rankings`	Bearer	Rank list for a category UUID from taxonomy. Items include vendor_id, rank_number, master_score, is_partner. Query: `page`, `perPage`
`GET`	`/v1/subcategories/{id}/rankings`	`/sandbox/v1/subcategories/{id}/rankings`	Bearer	Rank list for a subcategory UUID from taxonomy. Same shape as category rankings. Query: `page`, `perPage`

Path id values are UUIDs, not slugs. Lists use page (default 1) and perPage (default 50, max 100). Response: { items, page, perPage, total }. Production returns live vendors only. Sandbox returns the same shape from synthetic fixtures.

Machine-readable contract: OpenAPI JSON. How to call them: /doc. Try requests: /sandbox.