PostMantis
API ReferenceProfiles

List connected profiles

Returns all active publishing profiles visible to the authenticated API key. Use the returned profile ids when creating posts. Results are filtered by API-key scope if one is in use.

GET
/api/v1/profiles

Returns all active publishing profiles visible to the authenticated API key. Use the returned profile ids when creating posts. Results are filtered by API-key scope if one is in use.

Authorization

BearerAuth
AuthorizationBearer <token>

PostMantis API key from the dashboard. Include as Authorization: Bearer <key>.

In: header

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://loading/api/v1/profiles"
{  "data": [    {      "id": "4339a6bc-9cd3-455e-8f91-df8bc63f12d7",      "name": "PostMantis on X",      "provider": "x",      "status": "active",      "username": "postmantis",      "postsCount": 12,      "createdAt": "2026-05-05T10:00:00.000Z",      "updatedAt": "2026-05-05T10:00:00.000Z"    }  ]}
{  "type": "https://postmantis.com/problems/unauthorized",  "title": "Unauthorized",  "status": 401,  "detail": "Authentication required.",  "code": "unauthorized"}
{  "type": "https://postmantis.com/problems/rate-limited",  "title": "Too many requests",  "status": 429,  "detail": "Too many requests.",  "code": "rateLimited"}