List a location's scans

get

https://platform.reactvision.xyz/functions/v1/vps/locations/{location_id}/scans

Secret key only. Scope: vps.

Also accepts a user token.

Every scan of the location, newest first, accepted or not, a page at a time. Pass next_cursor as cursor for the next page; it is null on the last.

With x-app-user-id, or a user token, the request sees that app user's scans and the shared ones. Any other scan answers 404 NOT_FOUND, the same as one that does not exist.

Not counted against the monthly API request quota.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

location_id

uuid

required

Location id.

Query Params

limit

integer

1 to 200

Defaults to 50

Page size, 1 to 200. Default 50.

cursor

string

The previous page's next_cursor. Left out, the first page.

Headers

x-project-id

uuid

required

The project. With a client key or a bound secret key, the key's own project; with a user token, the token's project.

x-app-user-id

string

length between 1 and 255

Your id for the signed-in app user: 1 to 255 printable ASCII characters, no spaces, not . or ... With a secret key, the request acts for that app user: it sees the app user's locations and scans and the shared ones, and changes only the app user's own. With a user token, leave it out or send the token's own app user; another one answers 403 APP_USER_MISMATCH. A client or legacy key cannot send it (403 APP_USER_ID_NOT_ALLOWED).

Responses

`MISSING_PROJECT_ID`: no `x-project-id` header.

`INVALID_PROJECT_ID`: `x-project-id` is not a UUID.

`INVALID_APP_USER_ID`: `x-app-user-id` is not 1 to 255 printable ASCII characters without spaces, or is `.` or `..`.

`BAD_REQUEST`: `limit` is not 1 to 200.

`INVALID_BODY`: `cursor` is not one this API issued.

`MISSING_API_KEY`: no `x-api-key` header and no user token.

`INVALID_API_KEY_FORMAT`: the key is not `rv_live_`, `rv_client_` or `rv_secret_` followed by 64 lowercase hexadecimal characters.

`INVALID_SESSION_FORMAT`: the `Authorization` header is not `Bearer` followed by a user token.

`INVALID_API_KEY`: no such key, or a key sent with the wrong prefix for its type.

`API_KEY_EXPIRED`: the key is past its expiry date.

`INVALID_APP_USER_TOKEN`: the user token is not valid, or the secret key that minted it has been deleted or has expired.

`APP_USER_TOKEN_EXPIRED`: the user token has expired. Get a new one from your backend.

`INVALID_SESSION`: a Bearer token that is neither a user token nor a ReactVision Editor session.

List a location's scans

`NOT_FOUND`: no such location, or one the request cannot see.

`RATE_LIMITED`: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in `Retry-After`. See Limits.

`INTERNAL_ERROR`: an unexpected error. Retry, and quote `meta.request_id` to support if it persists.

`AUTH_UNAVAILABLE`: the key or user token could not be checked. Retry; this does not mean it is invalid.

`VPS_LOOKUP_FAILED`: the records could not be read or written. Retry.

200A page of scans.

400MISSING_PROJECT_ID: no x-project-id header. INVALID_PROJECT_ID: x-project-id is not a UUID. INVALID_APP_USER_ID: x-app-user-id is not 1 to 255 printable ASCII characters without spaces, or is . or ... BAD_REQUEST: limit is not 1 to 200. INVALID_BODY: cursor is not one this API issued.

404NOT_FOUND: no such location, or one the request cannot see.

429RATE_LIMITED: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in Retry-After. See Limits.

500INTERNAL_ERROR: an unexpected error. Retry, and quote meta.request_id to support if it persists.

503AUTH_UNAVAILABLE: the key or user token could not be checked. Retry; this does not mean it is invalid. VPS_LOOKUP_FAILED: the records could not be read or written. Retry.

`NOT_FOUND`: no such location, or one the request cannot see.

`RATE_LIMITED`: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in `Retry-After`. See Limits.

`INTERNAL_ERROR`: an unexpected error. Retry, and quote `meta.request_id` to support if it persists.

`AUTH_UNAVAILABLE`: the key or user token could not be checked. Retry; this does not mean it is invalid.

`VPS_LOOKUP_FAILED`: the records could not be read or written. Retry.