Skip to main content
GET
/
v1
/
connections
/
auth-links
/
{auth_link_id}
/
status
Get auth link status
curl --request GET \
  --url https://api.markifact.com/v1/connections/auth-links/{auth_link_id}/status \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "connection_type": "<string>",
  "expires_at": 123,
  "created_at": 123,
  "updated_at": 123,
  "connections": [
    {
      "id": "<string>",
      "type": "<string>",
      "is_private": true,
      "display_name": "<string>",
      "external_id": "<string>",
      "created_at": 123,
      "updated_at": 123
    }
  ],
  "connection_id": "<string>",
  "external_id": "<string>",
  "consumed_at": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.markifact.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns the current status of an auth link created by your team.

​
Endpoint

GET /v1/connections/auth-links/{auth_link_id}/status

​
Path Parameters

ParameterTypeDescription
auth_link_idstringAuth link ID returned by POST /v1/connections/auth-link.

​
Example Request

curl https://api.markifact.com/v1/connections/auth-links/7b6a5c4d-0000-0000-0000-000000000000/status \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "7b6a5c4d-0000-0000-0000-000000000000",
  "status": "connected",
  "connection_type": "ga4",
  "connection_id": "1f2e3d4c-0000-0000-0000-000000000000",
  "external_id": "customer_123",
  "expires_at": 1764086400000,
  "consumed_at": 1764000000000,
  "created_at": 1763999900000,
  "updated_at": 1764000000000,
  "connections": [
    {
      "id": "1f2e3d4c-0000-0000-0000-000000000000",
      "type": "ga4",
      "display_name": "login@example.com",
      "external_id": "customer_123",
      "is_private": false,
      "created_at": 1764000000000,
      "updated_at": 1764000000000
    }
  ]
}

​
Status Values

StatusDescription
pendingThe auth link has not been completed and has not expired.
connectedThe OAuth flow completed and the auth link was consumed.
expiredThe auth link expired before completion.

​
Connections

The connection_id field is populated after a successful OAuth flow. The connections array contains that exact connection when it is still available to your team. If the link is pending, expired, or the connection was later deleted, connections is an empty list. You can pass connection_id to Markifact MCP using X-Markifact-Context when you want an MCP request to use only this connected account: 
X-Markifact-Context: {"connection_ids":["1f2e3d4c-0000-0000-0000-000000000000"]}
Passing {"connection_ids":[]} explicitly allows no connections for that request. Omit the header to use the MCP server’s normal saved connection settings.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
auth_link_id
string
required

Auth link ID returned by Create auth link.

Response

Auth link status returned.

​
id
string
required
​
status
enum<string>
required
Available options:
pending,
connected,
expired
​
connection_type
string
required
​
expires_at
integer<int64>
required
​
created_at
integer<int64>
required
​
updated_at
integer<int64>
required
​
connections
object[]
required
​
connection_id
string | null
​
external_id
string | null
​
consumed_at
integer<int64> | null