Search issued standards
POST/api/v2/bulk/standards/holders/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 companies (default 100000), each a complete document on its own, with standard and validator descriptions declared once at the top and referenced by id. Each company row carries its company id and the custom properties named in customPropertyIds, described once at the top the way the standards are; omitting that list returns no fields at all. Company details beyond those fields come from the companies search, joined on the id. Only companies with at least one qualifying holding appear; under the same searchBy this export is a subset of the companies search. Narrow the search by certification id, by a group your profile owns, or ask for every standard your API key can reach; at least one of those is required. Only validated certification holdings are returned; expired and in-progress ones are left out unless includeExpired / includeInProgress ask for them.
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 5000–100000.
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.