
# Limits

This page lists the limits that Enfonica enforces on the API, on webhooks, and on messages, calls, and phone numbers. Design your app to stay within them.

Only the Cloud SIP limits can be raised. If you expect to exceed one, [tell our team](https://enfonica.com/contact-support) before you launch.

## All APIs

| Limit | Value |
|---|---|
| Items in one page of a list | 10 by default, and 100 at most. A `pageSize` above 100 returns `INVALID_ARGUMENT`. |
| Access token lifetime | Up to one hour. Your app gets a new token before the old one expires. See [Authentication](../authentication/index.md). |

## Cloud SMS

| Limit | Value |
|---|---|
| Message length | 10 segments. That's 1,530 characters when every character is in the GSM-7 alphabet, or 670 characters when any character isn't, such as an emoji. A longer `body` is cut to fit. The `segmentCount` in the response shows how many segments were sent. |
| Segment size | In GSM-7, a message of up to 160 characters is one segment, and a longer message is split into segments of 153. In Unicode (UCS-2), the sizes are 70 and 67. |
| Recipients | One `to` number in each request. |
| Sender ID | Up to 11 characters. See [Alphanumeric sender IDs](../cloud-sms/alphanumeric-sender-id.md) for the characters that it can use. A message to an Australian number from a sender ID that isn't [registered](../cloud-sms/australian-sender-id-register.md) to your project returns `FAILED_PRECONDITION`, with the message "This sender ID is not registered for Australian SMS." |
| Opt-outs | A message to a number that has replied STOP returns `FAILED_PRECONDITION`, with the message "Recipient is unsubscribed". A message whose `classification` is `TRANSACTIONAL` isn't checked, and is sent. See [How SMS opt-outs (STOP) work](https://enfonica.com/help/sms/sms-opt-outs). |
| Labels on a message | 50. A key has up to 100 characters, and a value has up to 1,000. |
| `statusUpdateUrl` | An absolute URL of up to 2,000 characters. |
| Time to answer a webhook | 10 seconds. |
| Webhook redirects | Enfonica follows up to 5 redirects. |
| Webhook retries | Each handler URL is tried once. If they all fail, Enfonica tries 8 more times, after 1, 2, 4, 8, 60, 1,800, 3,600, and 7,200 seconds. That's more than three hours in total. A slow response is also retried, so your server can receive the same webhook more than once. See [Message webhooks](../cloud-sms/webhooks.md#response). |
| MessageML | Up to 10 `<Message>` actions in a response, and up to 10 redirects for one incoming message. See [MessageML](../cloud-sms/messageml.md). |

## Cloud Voice

| Limit | Value |
|---|---|
| Call length | 4 hours. Enfonica ends a call that reaches this length. |
| Time to answer a VoiceML request | 10 seconds. |
| VoiceML retries | None. Enfonica tries each of the call's handler URLs once, in order. If none returns VoiceML, the call fails. |
| Handler URLs | Up to 5 for a call. |
| VoiceML document | Up to 100,000 characters. |
| VoiceML requests in one call | 2,000. This also stops a `<Redirect>` loop. |
| [`<Call>`](../cloud-voice/voiceml/call.md) | Up to 10 endpoints. `TimeoutSeconds` can be up to 600, and `MaxDurationSeconds` up to 14,400 (4 hours). |
| [`<Record>`](../cloud-voice/voiceml/record.md) | Up to 3,600 seconds (one hour). |
| [`<Say>`](../cloud-voice/voiceml/say.md) | Up to 5,000 characters of text. Voices are in English. |
| [`<Stream>`](../cloud-voice/voiceml/stream.md) | Audio is G.711 (mu-law or A-law) at 8 kHz, over gRPC. A call must connect to a stream within 30 seconds of the stream being created. |
| Time to answer an event webhook | 10 seconds. Event webhooks, such as `CALL_STATE_UPDATE` and `RECORDING_READY`, are retried in the same way as Cloud SMS webhooks. See [Voice webhooks](../cloud-voice/webhooks.md#response). |
| Recording download links | A link from the API is valid for 60 minutes. A link in a `RECORDING_READY` or `FAX_READY` webhook is valid for 24 hours. |

## Cloud SIP

By default, an account has 100 concurrent calls and 10 outgoing call attempts per second. We raise both on request. See [Cloud SIP limits](../cloud-sip/limits.md).

A SIP domain for [Microsoft Teams Direct Routing](../cloud-sip/guides/teams-direct-routing.md) has its own channel limit for outgoing calls. It starts at 1, and you can increase it.

## Phone Numbers

| Limit | Value |
|---|---|
| Buying | One number in each request. A number that you buy from Enfonica's stock is active immediately. |
| Regulatory listing | Australian local and mobile numbers, and New Zealand local numbers, need a compatible [regulatory listing](../phone-numbers/regulatory-guidelines/overview.md). Without one, the request to buy the number returns `INVALID_ARGUMENT`. |
| Handler URLs on a number | Up to 5 for incoming calls, and up to 5 for incoming messages. Each has up to 2,000 characters. |
| Labels on a number | 50. A key has up to 100 characters, and a value has up to 1,000. |

## Not supported

- **MMS.** Cloud SMS sends and receives text messages only.
- **WebRTC.** There's no SDK for calling from a browser or a mobile app.
- **A phone system (PBX).** [Cloud SIP](../cloud-sip/overview.md) provides SIP trunks that connect your own phone system to the phone network.
