> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arnio.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Contact Messages

Fetch all messages for a specific contact by their ID.

### Parameters

| Name  | In    | Type    | Required | Description                               |
| ----- | ----- | ------- | -------- | ----------------------------------------- |
| id    | path  | string  | ✅        | The ID of the contact                     |
| page  | query | integer | ❌        | Page number for pagination (default: 1)   |
| limit | query | integer | ❌        | Number of messages per page (default: 20) |

### Responses

* **200**: Messages retrieved successfully. Returns an array of message objects:

```json theme={null}
{
  "messages": [
    {
      "id": "GUID",
      "from": "+15551234567",
      "to": "+15557654321",
      "direction": "outbound",
      "message": "Hello",
      "timestamp": "2025-08-28T12:34:56Z",
      "attachments": [],
      "service": "iMessage",
      "status": {
        "read": false,
        "delivered": true
      }
    }
  ]
}
```


## OpenAPI

````yaml get /contacts/{id}/messages
openapi: 3.0.3
info:
  title: Contacts API
  version: 1.0.0
  description: API for managing contacts
servers:
  - url: https://api.arnio.co/api/v1
security:
  - ApiKeyAuth: []
paths:
  /contacts/{id}/messages:
    get:
      tags:
        - Contacts
      summary: Get contact messages
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: ID of the contact
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Page number for pagination
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
          description: Number of messages per page
      responses:
        '200':
          description: Messages retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  messages:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        from:
                          type: string
                        to:
                          type: string
                        direction:
                          type: string
                        message:
                          type: string
                        timestamp:
                          type: string
                          format: date-time
                        attachments:
                          type: array
                          items:
                            type: object
                        service:
                          type: string
                        status:
                          type: object
                          properties:
                            read:
                              type: boolean
                            delivered:
                              type: boolean
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Provide your API key

````