List Contra Conversations

PythonSocial Media
POST api.upapi.io/contra-list-conversations.get

Read one page of your signed-in Contra inbox. Returns the conversation nodes exactly as Contra sends them plus the pagination cursor. Uses your own Contra account; upAPI stores nothing.

contramessaging
AuthAPI key
Cost4 units
Timeout45s
CacheNone

Request schema

FieldTypeDescription
after
Opaque cursor from a previous page's endCursor.· default: null
docId
Override the pinned persisted-query id for this call.· default: null
first
integerPage size.· default: 30
filter
objectContra's own conversation filter object, forwarded verbatim, e.g. {"archived": false}. Omit for the default bucket.
proxyUrl
Exit IP pinned to this account. Omit to use the shared pool.· default: null
sessionCookiesreq
objectContra session cookies for the inbox owner. Your own Contra account's cookies; upAPI stores nothing.

Response schema

FieldTypeDescription
itemsreq
array
elapsedMsreq
integer
endCursorreq
fetchedAtreq
string
itemCountreq
integer
hasNextPagereq
boolean

Try it

Try it

Contra session cookies for the inbox owner. Your own Contra account's cookies; upAPI stores nothing.

Opaque cursor from a previous page's endCursor.

Override the pinned persisted-query id for this call.

Page size.

Contra's own conversation filter object, forwarded verbatim, e.g. {"archived": false}. Omit for the default bucket.

Exit IP pinned to this account. Omit to use the shared pool.

Run this endpoint live

Jump in as a guest — no signup — and run contra-list-conversations.get with your own inputs. Create a free account anytime to get your own API key.

Sign in

Code examples

curl -X POST https://api.upapi.io/contra-list-conversations.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "first": 30, "sessionCookies": {} }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.