Skip to main content
GET
/
introspect
JavaScript
import Finch from '@tryfinch/finch-api';

const client = new Finch({
  accessToken: 'My Access Token',
});

const introspection = await client.account.introspect();

console.log(introspection.id);
{
  "id": "<string>",
  "connection_id": "<string>",
  "connection_status": {
    "status": "pending",
    "message": "<string>",
    "last_successful_sync": "2023-11-07T05:31:56Z"
  },
  "client_id": "<string>",
  "client_type": "development",
  "connection_type": "finch",
  "company_id": "<string>",
  "account_id": "<string>",
  "customer_id": "<string>",
  "customer_name": "<string>",
  "customer_email": "<string>",
  "authentication_methods": [
    {
      "type": "assisted",
      "connection_status": {
        "status": "pending",
        "message": "<string>",
        "last_successful_sync": "2023-11-07T05:31:56Z"
      },
      "products": [
        "<string>"
      ]
    }
  ],
  "products": [
    "<string>"
  ],
  "username": "<string>",
  "provider_id": "<string>",
  "payroll_provider_id": "<string>",
  "manual": true,
  "entity_mode": "single",
  "entity_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string<date>
default:2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Response

200 - application/json

OK

​
id
string
required

The Finch UUID of the token being introspected

​
connection_id
string
required

The Finch UUID of the connection associated with the access_token

​
connection_status
object
required
​
client_id
string
required

The client ID of the application associated with the access_token

​
client_type
enum<string>
required

The type of application associated with a token.

Available options:
development,
production,
sandbox
​
connection_type
enum<string>
required

The type of the connection associated with the token.

  • provider - connection to an external provider
  • finch - finch-generated data.
Available options:
finch,
provider
​
products
string[]
required

An array of the authorized products associated with the access_token.

​
provider_id
string
required

The ID of the provider associated with the access_token.

​
company_id
string
deprecated

[DEPRECATED] Use connection_id to associate tokens with a Finch connection instead of this company ID

​
account_id
string
deprecated

[DEPRECATED] Use connection_id to associate tokens with a Finch connection instead of this account ID

​
customer_id
string | null

The ID of your customer you provided to Finch when a connect session was created for this connection

​
customer_name
string | null

The name of your customer you provided to Finch when a connect session was created for this connection

​
customer_email
string | null

The email of your customer you provided to Finch when a connect session was created for this connection

​
authentication_methods
object[]
​
username
string | null

The account username used for login associated with the access_token.

​
payroll_provider_id
string
deprecated

[DEPRECATED] Use provider_id to identify the provider instead of this payroll provider ID.

​
manual
boolean

Whether the connection associated with the access_token uses the Assisted Connect Flow. (true if using Assisted Connect, false if connection is automated)

​
entity_mode
enum<string>

Indicates whether this connection manages a single entity or multiple entities.

Available options:
single,
multi
​
entity_ids
string<uuid>[]

Array of entity IDs associated with this connection.

⌘I