GET/v1/accounts

List Accounts

Retrieve a paginated list of all connected platform accounts

This endpoint retrieves a paginated list of all connected platform accounts (like Twitter, LinkedIn, Facebook) associated with the authenticated user.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Response Structure

total_results
integer
Total number of accounts
Example: 2
limit
integer
Maximum results per page
Example: 50
page
integer
Current page number
Example: 1
total_pages
integer
Total number of pages
Example: 1
result_from
integer
Starting result index
Example: 1
result_to
integer
Ending result index
Example: 3
data
array
Array of account objects
Example: [...]
next
stringnull
URL for next page (null if last page)
Example: null
previous
stringnull
URL for previous page (null if first page)
Example: null

Account Object Fields

id
string
Unique account identifier
Example: 6e5f36d27502ec69fda745ec59ead509
object
string
Always "account"
Example: account
username
string
Platform username
Example: MisterDebugger
created_at
string
Account creation timestamp (ISO 8601)
Example: 2025-02-11T08:28:14Z
last_synchronization_time
string
Last sync timestamp
Example: 2025-02-11T08:28:14Z
status
string
HTTP status code
Example: 200
status_code_info
string
Status information
Example: synchronized
status_code_description
string
Human-readable status message
Example: Success!
type
string
Account type identifier
Example: facebook-sync
params
object
Account parameters (default and user-specific)
Example: {default: {}, user: {}}
updated_at
stringnull
Last update timestamp
Example: null
account_type_hash
string
Account type identifier hash
Example: 16f5b7f91e8fc533eab88be973273a02
squids
array
Array of squids using this account
Example: []
baseurl
string
Platform base URL
Example: https://www.facebook.com
cookies
array
Required cookie names for authentication
Example: [{name: c_user, required: true}]
icon
string
Base64 encoded platform icon
Example: <base64 image data>
Pro Tip

Pro Tip

Use this endpoint to check which platform accounts are currently synced and their status before running squids that require authentication.
Note

Note

The squids array shows which squids are currently using each account, helping you manage account usage across your projects.
Warning

Warning

Check the status_code_info field to identify accounts with expired cookies that need re-synchronization.