# Conversations

> Reference generated from the OpenAPI contract: Conversations.

URL : https://docs.fanconvert.ai/en/api/reference/conversations

{/* Généré par scripts/generer-reference.mjs depuis openapi/public-v1.json : ne pas modifier à la main. */}

## Les conversations d'une créatrice [#les-conversations-dune-créatrice]

`GET /public/v1/creators/{creator_id}/conversations` · `listConversations`

### Parameters [#parameters]

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `creator_id` | path | string | yes | Identifiant de la créatrice. |
| `platform` | query | "mym" \| "telegram" \| "onlyfans" | no | La plateforme de la conversation. (default : `mym`) |
| `limit` | query | integer | no | Taille de la page. (default : `50`) |
| `cursor` | query | string \| null | no | Le `nextCursor` de la page précédente. |

### Response 200 [#response-200]

**`Page_Conversation_`**

| Field | Type | Required | Description |
|---|---|---|---|
| `items` | Conversation[] | yes |  |
| `nextCursor` | string \| null | no | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |

**`Conversation`**

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Identifiant de la conversation sur sa plateforme (MYM : le chat id). |
| `platform` | "mym" \| "telegram" \| "onlyfans" | yes |  |
| `fan` | Fan | yes |  |
| `lastFanMessageAt` | string (date-time) \| null | yes |  |
| `lastMessageAt` | string (date-time) \| null | yes |  |
| `unreadCount` | integer \| null | no | Messages du fan non lus, quand la plateforme les compte. |
| `hasPurchased` | boolean \| null | no |  |

**`Fan`**

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string \| null | yes |  |
| `username` | string \| null | no |  |

### Possible errors [#possible-errors]

`401` · `403` · `404` · `422` · `429` · `503` — Error format: [Errors](/en/api/rest/erreurs).

### Example [#example]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Les messages d'une conversation [#les-messages-dune-conversation]

`GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/messages` · `listMessages`

### Parameters [#parameters-1]

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `creator_id` | path | string | yes | Identifiant de la créatrice. |
| `conversation_id` | path | string | yes | Identifiant de la conversation. |
| `platform` | query | "mym" \| "telegram" \| "onlyfans" | no | La plateforme de la conversation. (default : `mym`) |
| `limit` | query | integer | no | Taille de la page. (default : `50`) |
| `cursor` | query | string \| null | no | Le `nextCursor` de la page précédente. |

### Response 200 [#response-200-1]

**`Page_Message_`**

| Field | Type | Required | Description |
|---|---|---|---|
| `items` | Message[] | yes |  |
| `nextCursor` | string \| null | no | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |

**`Message`**

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes |  |
| `direction` | "fan" \| "creator" | yes |  |
| `text` | string | yes |  |
| `sentAt` | string (date-time) \| null | yes |  |
| `media` | MessageMedia[] | yes |  |

**`MessageMedia`**

| Field | Type | Required | Description |
|---|---|---|---|
| `status` | "paid" \| "pending" \| "refused" \| "free" \| "unknown" | yes |  |
| `priceMinor` | integer \| null | no |  |
| `currency` | string \| null | no |  |

### Possible errors [#possible-errors-1]

`401` · `403` · `404` · `422` · `429` · `503` — Error format: [Errors](/en/api/rest/erreurs).

### Example [#example-1]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/messages" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```