Search standards
POST/api/v2/bulk/standards/search
This request is queued, not processed while you wait. The response carries a correlation id — poll the bulk task until it reports a terminal state. See How asynchronous processing works.
Queued, not immediate — the response carries a correlation id to poll on GET /api/v2/bulk/tasks/{correlationId}. The finished task lists one entry per result page: gzipped JSON files of at most pageSize standards (default 5000), each a complete document on its own. Narrow by certification id, by a group your profile owns — group mode is exclusive: it returns the standards held by the group's members and ignores the other options — or ask for every standard your API key can reach; at least one of those is required. Each standard carries its owner as an id and name, so the owner joins against the company ids the companies search returns. Use this to learn the standard ids the import endpoints expect.
Request
Responses
- 200
- 400
- 403
Queued. The correlation id means the search has started, not that a result file exists yet.
Returned when the request narrows by nothing, carries an empty array where ids are required, or asks for a page size outside 100–10000.
Group-ownership denials are not returned here: the search is queued before the group check runs, and a request naming a group your profile doesn't own completes with that denial in the finished task's errors.