Chat Exports

Get Recent Chat Exports

get

Export chat history for all contacts with recent activity within the specified number of hours. Supports JSON (default) and plain text file formats.

Text format returns a downloadable .txt file attachment with all conversations combined. JSON format returns structured data with per-contact message exports.

Authorizations

ApiKeyAuthUserIdAuth

apiKeystringRequired

Your DM Champ API key. Obtain from Settings → API Keys.

Query parameters

apiKeystringOptional

API key for authentication. At least one of apiKey or userId is required for protected endpoints.

Example: your_api_key

userIdstringOptional

User ID for authentication. Alternative to apiKey. At least one of apiKey or userId is required for protected endpoints.

Example: your_user_id

hoursinteger · min: 1Required

Number of hours to look back for recent contact activity

Example: 24

formatstring · enumOptional

Output format. Use 'txt' to download a plain text file attachment.

Default: jsonPossible values:

limitinteger · min: 1Optional

Maximum number of contacts to export

Default: 50

filterstring · enumOptional

Filter messages by type:

• all: Include all messages
• media: Only messages with media attachments
• tool_use: Only tool use / AI action messages
• text: Only plain text messages (no media, no tool use)

Default: allPossible values:

Responses

200

Chat exports retrieved successfully. When format=txt, returns a downloadable text file. When format=json (default), returns structured JSON.

application/jsontext/plain

successbooleanOptionalExample: true

400

Missing or invalid hours parameter

application/json

401

Authentication required or invalid credentials

application/json

get

/chat-exports/recent

HTTPcURLJavaScriptPython

GET /v1/chat-exports/recent?hours=1 HTTP/1.1
Host: api.dmchamp.com
Accept: */*

{
  "success": true,
  "data": {
    "hours_ago": 24,
    "total_contacts": 10,
    "exports": [
      {
        "contactId": "text",
        "contactName": "text",
        "phoneNumber": "text",
        "email": "text",
        "messageCount": 1,
        "chatExport": "text"
      }
    ]
  }
}