Request registrations

Starts a job to find a legal entity's registrations, such as Secretary of State filings. Use it when you want Coris to fetch filings it does not hold yet. To read what Coris has stored, use Get legal entity registrations.

Lifecycle: POST returns 201 and a request_id. Poll the GET route with that request_id: 425 means not ready or awaiting manual review, and 200 means complete. If you send callback_url, Coris posts the result when it is done, as Handle async requests explains.

sequenceDiagram
  accTitle: Request registrations sequence diagram
  accDescr: Request registrations. You send POST .../registrations/. Coris replies 201 request_id. You send GET ?request_id=... Coris replies 425 no data yet. You send GET ?request_id=... Coris replies 200 complete. Coris sends POST callback_url, if sent.
  participant You
  participant Coris
  You->>Coris: POST .../registrations/
  Coris-->>You: 201 request_id
  You->>Coris: GET ?request_id=...
  Coris-->>You: 425 no data yet
  You->>Coris: GET ?request_id=...
  Coris-->>You: 200 complete
  Coris->>You: POST callback_url, if sent
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
Body Params

Business Registrations Request

boolean
Defaults to false

When true, a search that finds nothing goes to manual review, and polling returns 425 until it ends. When false, the job finishes with what it found.

uri

A public HTTPS URL where Coris posts the result, if you want to skip polling.

integer

The minimum delay before the callback, in seconds, up to a recommended 3600. Send it if you might receive the callback before you store request_id.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Callback
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html