Skip to main content
GET
/
connect
/
{connect_token}
Retrieve a Connect session
curl --request GET \
  --url https://api.flatpeak.com/connect/{connect_token} \
  --header 'Authorization: Bearer <token>'
{
  "id": "cot_6587fa4362341be5b524de3b",
  "location_id": "loc_641b90b758fb8e6293716e40",
  "object": "connect_session",
  "live_mode": true,
  "data_available": true,
  "time_created": "2023-05-05T18:37:27Z",
  "time_expiry": "2023-12-28T03:00:00Z",
  "device_id": "dev_63a6087272941ef077a8fd3e",
  "provider_id": "prv_6a2b2460ba2259a0c4980afb",
  "connect_url": "myapp://nova/flatpeak/connect",
  "callback_url": "myapp://nova/flatpeak/complete"
}

Authorizations

Authorization
string
header
required

Authenticate with bearer you obtained from authentication endpoint.

Path Parameters

connect_token
string
required

Flatpeak Connect Token.

Response

Response example

id
string
required

Flatpeak connect_token id.

Example:

"cot_6587fa4362341be5b524de3b"

location_id
string
required

Flatpeak location id.

Example:

"loc_641b90b758fb8e6293716e40"

object
string
required

Flatpeak object name, i.e. connect_token.

Example:

"connect_session"

live_mode
boolean
required

Set to true when object is in live mode.

Example:

true

data_available
boolean
required

Set to true when data is available to fetch.

time_created
string
required

Time when the object was created, in UTC.

Example:

"2023-05-05T18:37:27Z"

time_expiry
string
required

Time when the token will expire. Expired tokens cannot be claimed.

Example:

"2023-12-28T03:00:00Z"

device_id
string

Flatpeak Device ID

Example:

"dev_63a6087272941ef077a8fd3e"

provider_id
string

Flatpeak Provider ID

Example:

"prv_6a2b2460ba2259a0c4980afb"

connect_url
string
Example:

"myapp://nova/flatpeak/connect"

callback_url
string
Example:

"myapp://nova/flatpeak/complete"