Request establishment rating

Use this when you hold an establishment.id: it starts a job to rate a business and its website. Use it when you want ratings without holding a connection open. For an account, use Request account rating.

Lifecycle: POST returns 201 and a request_id. Poll Get establishment rating with that request_id: 425 means not ready, 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 establishment rating sequence diagram
  accDescr: Request establishment rating. You send POST .../ratings/. Coris replies 201 request_id. You send GET ?request_id=... Coris replies 425 not ready. You send GET ?request_id=... Coris replies 200 complete. Coris sends POST callback_url, if sent.
  participant You
  participant Coris
  You->>Coris: POST .../ratings/
  Coris-->>You: 201 request_id
  You->>Coris: GET ?request_id=...
  Coris-->>You: 425 not ready
  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
uuid
required

The Coris ID of the establishment, from establishment.id in a search or profile.

Body Params

Business Rating Request

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