# Check Contra Session API

> Report whether a Contra session cookie is still authenticated. Returns the account id when it is and false when it is not. Uses your own Contra account; upAPI stores nothing.

Category: [Social Media APIs](https://upapi.io/apis/social-media) · Last updated 2026-10-31

## How to call it

- Endpoint: `POST https://api.upapi.io/contra-check-session.get`, key in the `X-Api-Key` header, JSON body.
- Cost: 1 weighted unit per call.
- Timeout: 45 seconds.
- Cache: none; every call runs the operation.
- Try it without writing code: https://app.upapi.io/try/contra-check-session.get

```bash
curl -X POST https://api.upapi.io/contra-check-session.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "sessionCookies": {} }'
```

## Request parameters

- `docId` (string) — Override the pinned persisted-query id for this call. Pass a freshly discovered 32-hex id when Contra has rotated its query ids.
- `proxyUrl` (string) — Exit IP pinned to this account. Omit to use the shared pool.
- `sessionCookies` (object, required) — Contra session cookies for the account whose session is being checked. Your own Contra account's cookies; upAPI stores nothing.

## Response fields

- `checkedAt` (string, required)
- `elapsedMs` (integer, required)
- `authenticated` (boolean, required)
- `userAccountId` (string, required)

## Example request and response

The example response is generated from the published output schema: it shows the shape and field names, not values from a recorded call.

```json
{
  "sessionCookies": {}
}
```

```json
{
  "checkedAt": "example",
  "elapsedMs": 1,
  "authenticated": false,
  "userAccountId": "example"
}
```

## Frequently asked questions

### How much does the Check Contra Session API cost per call?

Each call spends 1 weighted unit of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

### How do I authenticate to the Check Contra Session API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

### Are Check Contra Session API responses cached?

No — every call runs the operation live; responses are not cached.

## More Social Media APIs

- [Follow Contra Profile](https://upapi.io/apis/social-media/contra-follow-user)
- [Get Contra Company Profile](https://upapi.io/apis/social-media/contra-company-profile)
- [Get Contra Opportunity](https://upapi.io/apis/social-media/contra-job-detail)
- [List Contra Conversations](https://upapi.io/apis/social-media/contra-list-conversations)
- [List Contra Messages](https://upapi.io/apis/social-media/contra-list-messages)
- [Read Contra Job Feed](https://upapi.io/apis/social-media/contra-job-feed)
- [Search Contra Freelancers](https://upapi.io/apis/social-media/contra-discover-people)
- [Send Contra Message](https://upapi.io/apis/social-media/contra-send-message)