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
}
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. This is the recommended option when your MCP client supports custom headers: 
X-Markifact-Context: {"connection_ids":["CONNECTION_ID"]}
If your MCP client does not support custom headers, pass the connection ID in the MCP URL instead: 
https://api.markifact.com/mcp?connection_ids=CONNECTION_ID
Passing {"connection_ids":[]} or using ?connection_ids= explicitly allows no connections for that request. Omit runtime context to use the MCP server’s normal saved connection settings. If both the header and query parameter are provided, X-Markifact-Context is used.

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