> ## 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.

# Receiving Messages

> Description of your new file.

Inbound messages are also delivered via webhooks. You must register the webhook in your Arnio Dashboard

<Danger>
  **Caution**

  A user must be registered as a contact on your account before their messages will be routed to you. This can be done by sending them a message or adding them as a contact.

  Need receive-first texting? [Talk to us](mailto:hello@arnio.co) about our dedicated plans.
</Danger>

Learn more here:  [https://docs.arnio.co/api-reference/endpoint/get-messages](https://docs.arnio.co/api-reference/endpoint/get-messages)

<img src="https://mintcdn.com/replyblue/D14xHZ-adayQZ19E/images/Screenshot2025-09-07at4.27.21PM.png?fit=max&auto=format&n=D14xHZ-adayQZ19E&q=85&s=e64f8bdead5c089252faecb005da5200" alt="Screenshot2025 09 07at4 27 21PM Pn" width="1438" height="914" data-path="images/Screenshot2025-09-07at4.27.21PM.png" />

```json theme={null}
{
  "accountEmail": "support@arnio.co",
  "content": "Hey there!",
  "media_url": "https://cdn.example.com/image.png",
  "is_outbound": false,
  "status": "RECEIVED",
  "error_code": null,
  "error_message": null,
  "message_handle": "xxxxx",
  "date_sent": "2025-09-10T06:15:05.962Z",
  "date_updated": "2025-09-10T06:15:05.962Z",
  "from_number": "+19998887777",
  "number": "+19998887777",
  "to_number": "+15122164639",
  "was_downgraded": false,
  "plan": "enterprise"
}
```

# **Error Codes**

| **Code** | **Description**                           |
| :------: | :---------------------------------------- |
|   4000   | Validation error (see error\_message)     |
|   4001   | Rate limit exceeded                       |
|   4002   | Blacklisted number (e.g. emergency lines) |
|   5000   | Internal error                            |
|   5003   | Server rate exceeded                      |
|   10001  | Message failed to send                    |
|   10002  | Failed to resolve message status          |

# **Message Length**

Messages must be fewer than **18,996 characters**. Longer content should be split into multiple messages.

# **Useful Information**

### **From Number**

Each customer will always interact with your brand through the **same dedicated Arnio number** to maintain consistency and trust.

### **Handles**

Every message has a unique message\_handle, allowing you to query or resolve its status later  especially useful in high-volume or queued scenarios.