Skip to main content
A name is a poor way to find one thing. The same name can belong to 2 companies, one paper is cited under 3 spellings of its title, and a draft can cite a court case that was never decided. An identifier names exactly one thing: a DOI names one paper, a docket number one case, a registry number one company. A search takes identifiers beside the question, or in place of it.

Search by an identifier

Send the code in subject_identifiers, with its scheme. This search looks up one paper by its DOI.
The search needs no query here: the code itself is searched. The datasources that can look up a DOI are added to the search, and the response lists each of them with the reason identifier. A result says which of your codes it matches. This response is cut to that part of its first result.
201 Created
A result can also have declared, which is what the datasource says about the item: its authors, its publisher, its version, its license, and its status.

Choose the scheme

A search takes up to 10 identifiers of these 16 schemes. The number of a certificate or of a license is sent as registry, with the body that issued it.

Give the issuer where a scheme needs one

A docket number means nothing without its court, and a ticker nothing without its exchange. The schemes docket, ticker, tax_id, and registry need an issuer.
Part of a request
Replace DOCKET_NUMBER with the number of the case. The codes of the issuers are in the catalog. Each datasource that can look up such a scheme lists the issuers it knows, so an agent reads a code from the catalog and does not guess one. If a request has a code that no datasource lists, it is refused, and the problem has the codes that are allowed.

Check a citation before it is used

A draft cites a case by its docket number. Search by the number, and a result that matches it says the case is in the register, with its address to read. A search that finds nothing has the outcome reason none. That outcome is not proof that the case does not exist. It says that the datasources named in the response do not have it, and the response names them.

Separate what a subject says from what others say

An identifier also tells the search who the subject is. With the subject known, each result says in source_profile.independence whether its publisher is the subject itself, self, or independent of it, independent. source_independence returns only one of the 2 sides.
Request body
Replace LEI_CODE, ISIN_CODE, and TICKER_SYMBOL with the company’s codes. The 3 codes name one company, so a namesake cannot enter the results, and the question runs in 4 wordings and 3 languages. Run the search once for each side, and a diligence report can have 2 columns: what the company says of itself, and what independent sources say.

Check what a lookup costs

A search by identifier is charged as any search: one unit for the search and one for each wording on each datasource. Each identifier without a query counts as one wording.