# Example requests

> Copy-and-paste, read-only requests for listing media kits, social accounts, decks, and campaigns.
>
> Canonical URL: https://docs.creatorsjet.com/api/quick-starts

These examples only read data. They do not change your CreatorsJet account, which makes them a safe first test after you [create an API key](/api/getting-started).

> **Info — Working in an AI assistant?:**
>
> Use the [MCP example requests](/mcp/quick-starts) instead. This page is for a terminal or your own code.

## Before you start

Set the key once in your terminal session:

```bash
export CREATORSJET_API_KEY="paste-your-api-key-here"
```

Replace sample IDs with IDs returned by CreatorsJet. Keep the key private: never paste it into a website, spreadsheet, or chat message.

## List your media kits

Creator keys return the creator's visible media kits. Agency keys return kits owned by the agency.

```bash
curl "https://api.creatorsjet.com/public/v1/media-kits?limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

An agency can limit the result to one roster creator:

```bash
curl "https://api.creatorsjet.com/public/v1/media-kits?creator_id=66b0f51d46071dc43b2db103&limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

Requires `media_kits:read`.

## List connected social accounts

A creator key lists the connected social accounts for the creator represented by the key:

```bash
curl "https://api.creatorsjet.com/public/v1/socials?limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

An agency key must name a creator already in its roster. This example returns only that creator's Instagram accounts:

```bash
curl "https://api.creatorsjet.com/public/v1/socials?creator_id=66b0f51d46071dc43b2db103&platform=instagram&limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

Creator keys need `profile:read`; agency keys need `roster:read`. Results include a platform, username, profile URL, and connection status. OAuth credentials are never returned.

## List agency pitch decks

Pitch decks belong to agencies:

```bash
curl "https://api.creatorsjet.com/public/v1/decks?limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

Requires `decks:read`.

## List active campaigns

Agency keys can list their agency's campaigns:

```bash
curl "https://api.creatorsjet.com/public/v1/campaigns?status=active&limit=10" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

Remove `status=active` to return all campaigns. Requires `campaigns:read`.

## Get the next page

Every list returns a `data` array. When there are more results, the response also includes `meta.next_cursor`. Pass that value unchanged in the next request:

```bash
curl "https://api.creatorsjet.com/public/v1/campaigns?limit=10&cursor=PASTE_NEXT_CURSOR_HERE" \
  --header "Authorization: Bearer $CREATORSJET_API_KEY"
```

## If something fails

| Status | What it usually means                                                            |
| ------ | -------------------------------------------------------------------------------- |
| `401`  | The key is missing, malformed, expired, or revoked.                              |
| `403`  | The key does not have the scope listed above, or the plan is no longer eligible. |
| `404`  | The resource is not visible to this key.                                         |

See [errors](/api/errors) for the full list of codes.