OAuth Applications

An OAuth Application lets you build an application for others to use with their Increase data. You can create an OAuth Application via the Dashboard and read information about it with the API. Learn more about OAuth here.

The OAuth Application object

{
  "client_id": "client_id_ec79nb1bukwwafdewe88",
  "created_at": "2020-01-31T23:59:59Z",
  "deleted_at": null,
  "id": "application_gj9ufmpgh5i56k4vyriy",
  "name": "Ian Crease's App",
  "status": "active",
  "type": "oauth_application"
}

Attributes

client_id

string

The OAuth Application’s client_id. Use this to authenticate with the OAuth Application.

created_at

string

The ISO 8601 timestamp when the OAuth Application was created.

deleted_at

string

Nullable

The ISO 8601 timestamp when the OAuth Application was deleted.

string

The OAuth Application’s identifier.

name

string

Nullable

The name you chose for this OAuth Application.

status

enum

Whether the application is active.

type

string

A constant representing the object’s type. For this resource it will always be oauth_application.

List OAuth Applications

curl \
  --url "${INCREASE_URL}/oauth_applications" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

Returns a list response :

{
  "data": [
    { /* OAuth Application object */ },
    { /* OAuth Application object */ }
    /* ... */
  ],
  "next_cursor": "v57w5d",
}

Parameters

status.in

array of strings

Return results whose value is in the provided list. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three.

cursor

string

limit

integer

created_at.after

string

created_at.before

string

created_at.on_or_after

string

created_at.on_or_before

string

Retrieve an OAuth Application

curl \
  --url "${INCREASE_URL}/oauth_applications/application_gj9ufmpgh5i56k4vyriy" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

Parameters

oauth_application_id

string

Required

The identifier of the OAuth Application.

More about OAuth Applications.