Verdocs - Authenticate

Request Body

application/json

Body Parameters

TypeScript Definitions

Use the request body type in TypeScript.

grant_type*string

The type of grant to request. API callers should nearly always use 'client_credentials'. Third-party OAuth2 integrations use 'authorization_code'.

Value in"client_credentials" | "refresh_token" | "password" | "authorization_code"

client_id?string

If grant_type is client_credentials, refresh_token, or authorization_code, the client ID to use.

Formatuuid

client_secret?string

If grant_type is client_credentials or authorization_code, the secret key to use.

Formatuuid

username?string

If grant_type is password, the username to authenticate with.

password?string

If grant_type is password, the password to authenticate with.

code?string

If grant_type is authorization_code, the authorization code received from the authorize endpoint.

redirect_uri?string

If grant_type is authorization_code, must match the redirect_uri used in the authorize request.

Formaturi

scope?string

Optional scope to limit the auth token to. Do not specify this unless you are instructed to by a Verdocs Support rep.

Response Body

`application/json`

curl -X POST "https://api.verdocs.com/v2/oauth2/token" \    -H "Authorization: Bearer ACCESS_TOKEN" \    -H "content-type: application/json" \    -d '{"param": "value"}'

{}

{
  "status": "ERROR",
  "error": "string"
}

{
  "status": "ERROR",
  "error": "string"
}

{
  "status": "ERROR",
  "error": "string"
}

{
  "status": "ERROR",
  "error": "string"
}

Authenticate

Request Body

Response Body

200application/json

400application/json

401application/json

404application/json

406application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`