{ "openapi": "3.2.0", "info": { "version": "2.1.0", "title": "Sinch Engage", "termsOfService": "https://www.sinch.com/legal/terms-and-conditions/", "contact": { "name": "Sinch Engage Support", "email": "support@app.sinch.com", "url": "https://support.app.sinch.com/hc/en-us/categories/10516535548943-Sinch-Engage-Developer-Guides" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "x-logo": { "url": "./logo.png" }, "description": "# Introduction\nThe Sinch APIs provide powerful business messaging capabilities across sending, receiving, and processing SMS, MMS, and rich messaging. \n\nAll requests to the Sinch REST API must be authenticated, this can either be done using Basic Authentication or by signing with a HMAC signature.\n\n\n\n# Base URI\n \nThe API uses the following base URI\n\nFor EU instance please use https://eu.app.api.sinch.com\n\nFor APAC instance, use https://au.app.api.sinch.com\n\n# Credentials\n \nTo access the API, an API key and secret are required.\n \n[Sign up for a developer account here to get access](https://support.app.sinch.com/hc/en-us/categories/10516535548943-Sinch-Engage-Developer-Guides)\n\n# Features\n### De-Duplication \nDe-Duplication helps you avoid having to undertake data cleansing before commencing send outs. \nIt automatically detects and withholds messages deemed to be duplicates through the use of a 24-hour window – if a message is sent to the same number with the same content within a 24hr period, the subsequent message(s) will be withheld and rejected. To enable this, you don't need to make any changes to your application, just an account configuration change by Sinch's support team.\n\n### Social Sending \nSocial Sending permits messages to be sent only during sociable hours - i.e. 8am to 6pm (based on your accounts local time zone - not local time). \nMessages sent outside of these hours are scheduled to be released during the next social time period. This feature helps businesses avoid send-outs during a time that would be deemed unsuitable by the customer. To enable this, you don't need to make any changes to your application, just an account configuration change by Sinch's support team.\n\n### Familiar Sender\nFamiliar Sender ensures all communication sent to a customer are from the same phone number. \nThis allows businesses to build trust and familiarity with their customers and not confuse them by changing outgoing numbers. To enable this, you don't need to make any changes to your application, just an account configuration change by Sinch's support team.\n\n### Character Converter\nCharacters in a message may not always fall within the GSM-7 supported character set, and when this occurs all \noutbound messages will be encoded using UCS-2 leading to the customer being double-charged for the SMS. Character Converter \ncan help you avoid being double-charged for your SMS by converting all characters into the GSM-7 format ensuring you always \nget the maximum characters into an SMS. Bear in mind, this will downgrade all your unicode characters so for instance, \nyour emojis will be translated into a string of unknown characters (eg: �). To enable this, you don't need to make any \nchanges to your application, just an account configuration change by Sinch's support team.\n\n# AI Integration\nAgent-readable copies of this reference are published on every docs build, so they never drift from the documentation you are reading. Nothing here needs an API key.\n\n* [llms.txt](https://developers.app.sinch.com/llms.txt) — a curated, token-budgeted index of the whole API. Point your tool here first.\n\n* [llms-full.txt](https://developers.app.sinch.com/llms-full.txt) — every reference and guide page inlined in one file, for when you want the whole corpus in context.\n\n* Per-page Markdown — one clean `.md` per operation, for example `https://developers.app.sinch.com/docs/api/messages/send-messages.md`. Use View as Markdown / Copy for LLM beside any section heading to grab just that page.\n\n* [openapi.yaml](https://developers.app.sinch.com/openapi.yaml) and [openapi.json](https://developers.app.sinch.com/openapi.json) — the machine-readable contract, authoritative for schemas and limits.\n\nEvery page declares these artifacts in its `` using `rel=\"describedby\"` (the llms.txt v2 discovery relation) and `rel=\"alternate\"`, and this specification's root `externalDocs` points at the curated index, so a crawler does not need to hard-code the paths.\n\nSetup instructions for Claude Code, Cursor, ChatGPT, and Perplexity, plus the versioning conventions, are in the [AI Integration guide](https://developers.app.sinch.com/docs/guides/ai-integration.md).\n" }, "servers": [ { "url": "https://eu.app.api.sinch.com", "description": "EU instance", "name": "EU" }, { "url": "https://au.app.api.sinch.com", "description": "APAC instance", "name": "APAC" } ], "tags": [ { "name": "Basic Authentication", "kind": "nav", "description": "\nEvery request requires an `Authorization` header in the following format:\n```plain\nAuthorization: Basic Base64(api_key:api_secret)\n```\nWhere the header consists of the Basic keyword followed by your Basic Authentication `api_key` and `api_secret` that you have been supplied by support, separated with a colon (:) which is then Base64 encoded.\n### Example request with Basic Authentication\n```plain\nPOST /v1/messages HTTP/1.1\nHost: eu.app.api.sinch.com\nAccept: application/json\nContent-Type: application/json\nAuthorization: Basic dGhpc2lzYWtleTp0aGlzaXNhc2VjcmV0Zm9ybW1iYXNpY2F1dGhyZXN0YXBp\n{\n \"messages\": [\n {\n \"content\": \"Hello World\",\n \"destination_number\": \"+61491570156\",\n \"format\": \"SMS\"\n }\n ]\n} \n```\n_Note: spaces are used as indentation in the body of the above request._" }, { "name": "HMAC Authentication", "kind": "nav", "description": "\nEvery request requires an `Authorization` header in the following formats:\nFor a request with a request body:\n```plain\nAuthorization: hmac username=\"\", algorithm=\"hmac-sha256\", headers =\"Date Content-MD5 request-line\", signature=\"\"\n```\n\nFor a request _without_ a request body:\n\n```plain\nAuthorization: hmac username=\"\", algorithm=\"hmac-sha256\", headers=\"Date request-line\", signature=\"\"\n```\n### To create this header\n#### Step 1\nAdd a `Date` header to the request using the current date time in [RFC7231 Section 7.1.1.2](http://tools.ietf.org/html/rfc7231#section-7.1.1.2) format\n#### Step 2\nIf the request has a body, add a header called `Content-MD5` where the value of this header is an MD5 hash of the request body, otherwise this header is not required\n#### Step 3\nCreate a signing string by concatenating the `Date` header, the\n`Content-MD5` header (if set) and the request line with line breaks:\n```plain\nDate: Sat, 30 Jul 2016 05:13:23 GMT\\nContent-MD5: 10fd4feab20d38432480c07301e49616\\nPOST /v1/messages HTTP/1.1\n```\nor\n```plain\nDate: Sat, 30 Jul 2016 05:13:23 GMT\\nGET /v1/messages/404b941b-2a29-469f-b114-9ea3e16bbe18 HTTP/1.1\n```\n#### Step 4\nCreate a SHA256 HMAC hash using the signing string and the secret key (both converted to bytes using UTF-8) ```HMAC-SHA256(signing string, secret)```\n#### Step 5\nBase64 encode the HMAC hash and include it as the signature in the ```Authorization``` header\n### Example request with body\n```plain\nPOST /v1/messages HTTP/1.1\nHost: eu.app.api.sinch.com\nAccept: application/json\nContent-Type: application/json\nDate: Sat, 30 Jul 2016 05:18:52 GMT\nAuthorization: hmac username=\"uCXUdoogNfCsehEClbO2\", algorithm=\"hmac-sha256\", headers=\"Date Content-MD5 request-line\", signature=\"Ia4G5lkhH/3NDYpix+8ZHUnp6bA=\"\nContent-MD5: 5407644fa83bec240dede971307e0cad\nContent-Length: 133\n{\n \"messages\": [\n {\n \"content\": \"Hello World\",\n \"destination_number\": \"+61491570156\",\n \"format\": \"SMS\"\n }\n ]\n}\n```\n_Note: spaces are used as indentation in the body of the above request._\n### Example request without body\n```plain\nGET /v1/messages/404b941b-2a29-469f-b114-9ea3e16bbe18 HTTP/1.1\nHost: eu.app.api.sinch.com\nAccept: application/json\nDate: Sat, 30 Jul 2016 05:18:52 GMT\nAuthorization: hmac username=\"uCXUdoogNfCsehEClbO2\", algorithm=\"hmac-sha256\", headers=\"Date request-line\", signature=\"NTUwMjUwNTVmZGYzZTIxODMyYjc1ZmM3M2EwZWQ1NzA3NzA4ZTZjNw==\" ```" }, { "name": "Sub-accounts", "kind": "nav", "description": "## Performing actions on behalf of sub-accounts\nUsing API keys at the parent account level, you can perform actions on behalf of a sub-account. \n\nThis feature is supported by the Messages, Replies, Delivery Reports and Webhooks APIs. \n\nTo do this\n include a header key ```Account``` with the sub-account ID as the value. For example:\n ```Account: mySubAccount```\n\n **Example request with Sending from sub-accounts**\n\n ```plain\n POST /v1/messages HTTP/1.1\n Host: eu.app.api.sinch.com\n Accept: application/json\n Content-Type: application/json\n Authorization: Basic dGhpc2lzYWtleTp0aGlzaXNhc2VjcmV0Zm9ybW1iYXNpY2F1dGhyZXN0YXBp\n Account: SubAccount\n {\n \"messages\": [\n {\n \"content\": \"Hello World\",\n \"destination_number\": \"+61491570156\",\n \"delivery_report\": true\n }\n ]\n } \n ```\n" }, { "name": "Messages", "description": "The Sinch Messages API provides a number of endpoints for building powerful two-way messaging applications. The Messages API provides access to three main resources:\n* Messages - Messages delivered from an application to a handset.\n* Delivery Reports - Real time reports on the delivery status of a message. As a message is processed, it's status may change several times before it is finally delivered to a handset.\n* Replies - Messages sent from a handset to an application. These messages are typically a reply to a previously sent message.\n![Message Flow](./message-flow.png)" }, { "name": "Source Address", "description": "The source address API provides several endpoints for you to request an SMS sender ID and track its approval status.\n\n### Sender address request vs sender address\n\nThis API uses two different resources, each with its own UUID:\n\n| | Sender address **request** | Approved sender **address** |\n|---|----------------------------|-----------------------------|\n| What it is | Your registration / verification application | The approved sender ID on your account |\n| Path | `/v1/messaging/numbers/sender_address/requests` | `/v1/messaging/numbers/sender_address/addresses` |\n| `id` returned by | **Request a Sender Address** (`POST .../requests`) | **Get all approved sender addresses** (`GET .../addresses`) |\n| Use that `id` for | Get request status, submit a verification code | Get, update, re-verify, or **delete** the sender |\n\nThe request `id` and the address `id` are **not the same**. After a sender is approved, call **Get all approved sender addresses** to obtain the address `id` before deleting or managing it. Using the request `id` on address endpoints (for example delete) returns `404 Not found`.\n\n**What is Trusted Sender ID?**\n\nSimply put, a sender ID is whatever you send a text message from. This is typically either a phone number, or a string of alphanumeric characters (commonly referred to as an \"Alpha Tag\").\n\nWith regulations surrounding SMS becoming much stricter all over the world in an effect to combat scam SMS messages, Sinch is working on \"Trusted Sender ID\" a concept that allows customers to request a Sender ID and have it verified.\n\nCurrently, Trusted Sender ID supports two types of Sender ID: Alpha Tags and Personal (\"Own\") Numbers. It will likely be extended to support additional number types, such as TFN and 10DLC where additional registration, (external) verification, and overall account allowlist of numbers will be required.\n\n### Alpha Tag\n Sending messages from your brand name is particularly ideal for SMS marketing and two-factor authentication, as it increases recognition and trust. There are, however, a few considerations to be aware of. \n \n Alpha tags are made up of 3-11 letters and/or numbers. Alpha tags must be registered and approved before sending and must have clear relevancy to your business and/or use case.\n \n Alpha Tags appear as the \"From\" number when you receive messages.\n \n A good alpha tag meets at least one of the following valid use cases: \n * Business names\n * Trademark names \n * Product or service name\n * an acronym, initialism, or contraction of your entity\n \n In addition to the requirements around clearly relating to the business, we typically advise the following for alpha tags to ensure maximum compatibility with the various carriers:\n * 6-11 characters long\n * Only contains characters from the following sets:\n * A-Z\n * a-z\n * 0-9\n * _ (underscore)\n * \\- (hyphen)\n \n Alpha Tags can currently be registered through the Source Address API for the following countries: ```AD```, ```AI```, ```AL```, ```AS```, ```AT```, ```AU```, ```AW```, ```BA```, ```BB```, ```BH```, ```BW```, ```CD```, ```CH```, ```CK```, ```CY```, ```DE```, ```DJ```, ```DK```, ```DM```, ```EE```, ```ES```, ```FI```, ```FJ```, ```FM```, ```FO```, ```FR```, ```GB```, ```GD```, ```GG```, ```GI```, ```GL```, ```GM```, ```GQ```, ```GR```, ```GY```, ```IL```, ```IM```, ```IS```, ```JE```, ```JM```, ```JP```, ```KI```, ```KY```, ```LA```, ```LI```, ```LS```, ```LT```, ```LU```, ```LV```, ```MC```, ```ME```, ```MH```, ```MO```, ```MR```, ```MS```, ```MT```, ```MV```, ```NC```, ```NF```, ```NL```, ```NO```, ```NR```, ```NU```, ```PF```, ```PM```, ```PT```, ```SB```, ```SC```, ```SE```, ```SH```, ```SL```, ```SM```, ```ST```, ```TC```, ```TD```, ```TO```, ```VC```, ```VG``` and ```WS```\n \n To register an Alpha Tag as a sender ID you must:\n 1. Make a request to the **Request a Sender Address** endpoint\n 2. Wait for the alpha tag to be approved. The status of the alpha tag can be monitored using the **Get status of a sender address request** endpoint\n \n Once the alpha tag has been approved, you can begin using it as a Sender ID for SMS messages.\n\n ### Personal Number\n A personal number, or \"My Own Number\", is a number that you own rather than one provided to you by Sinch. Typically, this is your personal mobile phone number. You may wish to register this number for use with our service so that you can easily send messages from a number already associated with your organisation.\n \n Before you can send messages using your own number, you need to verify that you have a right to use that number. Ensuring you have a right to use a phone number is an important regulatory requirement, aiming to prevent scam, spam, and misuse of messaging services.\n\n Personal numbers can currently be registered through the Source Address API for the following countries: ```AT```, ```AU```, ```CH```, ```CY```, ```DE```, ```DK```, ```EE```, ```ES```, ```FI```, ```GB```, ```HR```, ```IE```, ```IT```, ```LT```, ```LU```, ```LV```, ```MT```, ```NL```, ```NO```, ```PT```, ```SE```, and ```SI```\n\n To register a personal number as a Sender ID you must:\n 1. Make a request to the **Request a Sender Address** endpoint (store the **request** UUID for verification)\n 2. A unique verification code will be sent to the requested number\n 3. Make a request to the **Submitting a Verification Code** endpoint, using the verification code that was sent in the previous step. A 200 OK response will indicate the number has been verified and is ready for use.\n 4. To delete or manage the sender later, call **Get all approved sender addresses** and use the **address** UUID from that response (different from the request UUID in step 1).\n\n ⚠️ Own numbers need to be re-verified every 12 months. You will be notified by email that verification of your number is about to expire.\n\n ### Requesting a Source Address on behalf of a sub-account\n By default, all requests made through the API are made on behalf of the account that the API keys used to authorize the request were made on. API keys created on a parent account can request a source address on behalf of a sub-account. To do this, include a header key ```Account``` with the sub-account ID as the value. For example: \n ```Account: mySubAccount```\n\n **Example request with Request a Sender Address from a sub-account**\n ```plain\n POST /v1/messaging/numbers/sender_address/requests HTTP/1.1\n Host: eu.app.api.sinch.com\n Accept: application/json\n Content-Type: application/json\n Authorization: Basic dGhpc2lzYWtleTp0aGlzaXNhc2VjcmV0Zm9ybW1iYXNpY2F1dGhyZXN0YXBp\n Account: mySubAccount\n {\n \"sender_address\": \"+61341234131\",\n \"sender_address_type\": \"INTERNATIONAL\",\n \"usage_type\": \"OWN_NUMBER\",\n \"destination_countries\": [\n \"AU\"\n ],\n \"reason\": \"I confirm that my business has a valid use case\",\n \"label\": \"my number sample\"\n } \n ```\n *Note: The use of the Account header key applies to all Source Address endpoints.*\n" }, { "name": "Delivery Reports", "description": "If a callback URL is specified in the submit message request, then changes to the message status, \nreplies received in response to the message or delivery reports received for the message will be pushed via a HTTP POST request. An alternative to delivery reports via a callback URL is custom webhooks using the webhooks management API. \n\nAll notifications are JSON encoded and the request expects to receive a response in the HTTP 200 range. If a valid response isn't received the request will be retried in an exponentially backing off fashion.\n\nDelivery Reports may carry an additional charge. For pricing, please contact your Account Manager or Support Team ().\n\nTo include billing units in your delivery receipts via Webhooks, ensure that the switch \"Enable billing units in Delivery Reports and Callbacks\" is enabled in the API settings of your account.\n\nFor delivery reports or changes in the status of a message, the POST request to the specified URL will be as follows:\n \n _Note, multiple delivery report notifications will be received for a single message._\n\n```javascript\n{\n \"callback_url\":\"http://mockbin.org/bin/ac52ebd4-eca1-4c86-bf38-4dce79633906\",\n \"delivery_report_id\":\"693e87f2-a553-4281-9ffe-ddf04cbc4bf3\",\n \"source_number\":\"+61491570156\",\n \"date_received\":\"2016-11-03T11:49:02.807Z\",\n \"status\":\"delivered\",\n \"delay\":0,\n \"billing_units\":1,\n \"submitted_date\":\"2016-11-03T11:49:01.551Z\",\n \"original_text\":\"Hello world!\",\n \"message_id\":\"389dc1a8-62a4-4110-ba61-af94806c006f\",\n \"vendor_account_id\":{\n \"vendor_id\":\"SinchEU\",\n \"account_id\":\"MyAccount\"\n },\n \"error_code\":\"220\",\n \"metadata\":{\n \"key\":\"value\"\n }\n}\n```\n\n\nThe properties included in the notification are as follows:\n\n* **Callback URL**: The URL specified as the callback URL in the original submit message request.\n\n* **Delivery Report ID**: A unique ID for the delivery report that this notification represents.\n\n* **Source Number**: The destination address of the original message.\n\n* **Date Received**: The date and time at which this notification was generated in UTC.\n\n* **Status**: The status of the message as indicated by this delivery report. The status field can be one of the following values:\n\n * `enroute`: Message has been received by the gateway and is being processed (or waiting to be processed).\n\n * `submitted`: Message has been submitted to a provider/carrier for delivery.\n\n * `delivered`: Message delivery has been confirmed by the provider, including to the handset (where possible).\n\n * `expired`: The message has expired.\n\n * `rejected`: The message will not be delivered - permanent failure. Reasons may include usage limit exceeded, insufficient credit, number blocked, or content filtered\n\n * `failed`: The message has failed. Reasons may include no active routes to destination or undeliverable by downstream provider.\n\n* **Delay**: _Deprecated, no longer in use_\n\n* **Billing Units**: The number of billing units charged for the message.\n\n* **Submitted Date**: Date time status of the message changed in UTC. For a delivered DR this may indicate the time at which the message was received on the handset.\n\n* **Original Text**: Text of the original message.\n\n* **Message ID**: ID of the original message.\n\n* **Vendor Account ID**: The account used to submit the original message. The vendor will always be `SinchEU`\n\n* **Error Code**: A status code which provides additional information about the message status:\n\n * `101`: Message being processed by the gateway.\n \n * `102`: Message is being rerouted to a different provider after failing via the first provider.\n \n * `151`: Message held for screening.\n \n * `200`: Message submitted to downstream provider for delivery.\n \n * `210`: Message accepted by downstream provider.\n \n * `211`: Message is enroute for delivery by provider.\n \n * `212`: Message submitted. Delivery pending.\n \n * `213`: Message scheduled for delivery by downstream provider.\n \n * `220`: Message delivered.\n \n * `221`: Message delivered to the handset.\n \n * `320`: Message validity period has expired (prior to submission).\n \n * `401`: Message validity period has expired (before delivery).\n \n * `301`: Usage threshold reached. Message discarded.\n \n * `302`: Destination address blocked. Message discarded.\n \n * `303`: Source address blocked. Message discarded.\n \n * `304`: Message dropped. Contact support.\n \n * `305`: Message discarded due to duplicate detection.\n \n * `402`: Message rejected by downstream provider.\n \n * `403`: Message skipped by downstream provider.\n \n * `410`: Invalid source address.\n \n * `411`: Invalid destination address.\n \n * `412`: Destination address blocked.\n \n * `413`: SMS service unavailable on destination.\n \n * `414`: Destination unreachable.\n \n * `330`: Gateway failure.\n \n * `331`: Message discarded.\n \n * `332`: No available route to destination.\n \n * `333`: Source address unsupported for this destination.\n \n * `400`: Message failed; undeliverable.\n \n * `405`: Message cancelled or deleted by provider.\n" }, { "name": "Replies", "description": "Endpoints for checking and confirming inbound message replies (MO) received by your account." }, { "name": "Number Authorisation", "description": "The number authorisation API allows you to manage your blacklists. Sinch automatically adds numbers to your blacklist if people send one of the opt-out keywords in response to one of your messages.\nThis is a legal requirement. If you decide to handle the legal compliance yourself, calls to this endpoint will not affect your messages." }, { "name": "Dedicated Numbers", "description": "The Numbers API allows your to purchase, provision and configure the dedicated numbers assigned to your Sinch account. \n\nTo learn more about the benefits of dedicated numbers, and their use cases, visit our [feature page](https://support.app.sinch.com/hc/en-us/articles/10526389880207-Dedicated-numbers).\n\nThis is a paid feature and must be enabled on your account. Please contact [support@app.sinch.com](mailto:support@app.sinch.com) or your account manager.\n\n## Concepts\n\nThis API allows you to purchase and assign to your account a number from a pool of dedicated numbers. Dedicated numbers are priced differently according to their classification.\n\nThe following is the system by which we classify dedicated numbers. \n\n| Pattern Type | Gold| Silver |\n|---|---|---|\n| Same Number | Six of same (e.g. 999999) | Five of same (e.g. 999991 or 199999) | \n| Sequence | Six in sequence (e.g. 234567, or 765432) | Five in sequence (e.g. 245678, 456782, or 287654) |\n| Triplets | Two identical (e.g. 123123) or two double (e.g. 444666) | Identical pairs within triplets (e.g. 004008, or 400800), one identical and one in sequence (e.g. 444789, or 345777), or mirror image (e.g. 468864)| \n|Pair|Three identical (e.g. 454545)|Three non-identical (e.g. 447700) or three in sequence (e.g. 232425, or 090807)|\n\nAny numbers that do not meet the criteria for Gold or Silver are classified as Bronze.\n\nFor pricing on dedicated numbers please refer to the Numbers page in our Hub web portal, or speak with your Sinch Account Manager.\n" }, { "name": "Messaging Reports", "description": "The Sinch Reports API provides a number of endpoints for running reports of messages sent and received through\na Sinch Account. The API allows two kinds of reports, _Detailed Reports_ and _Summary Reports_.\n\nDetailed reports list all messages and the details of each message sent or received in a specified time period. Summary reports allow inbound and outbound message data to be aggregated on a number of dimensions.\n" }, { "name": "Short Trackable Links Reports", "description": "Short Trackable Links is a feature available to [Messaging API](https://support.app.sinch.com/hc/en-us/categories/10516535548943-Sinch-Engage-Developer-Guides) users whereby it automatically and seamlessly shortens any URL to just 22 characters. Every shortened URL is unique to each recipient.\n\nThe reporting API has endpoints specific to \nthis feature, allowing users to obtain details regarding \nthe number of click-throughs on each URL.\n\nTo enable this feature on your account, contact your account manager or contact support on [support@app.sinch.com](mailto:support@app.sinch.com).\n\nTo learn more about the benefits of the Short Trackable Links feature, [visit our feature page](https://support.app.sinch.com/hc/en-us/articles/10525004171919-Short-Trackable-Links-URL-shortener).\n" }, { "name": "Webhooks Management", "description": "Webhooks Management API allows you to manage your webhooks configuration. You can subscribe to one or several events, retrieve the webhooks, update them or even delete them if needed." }, { "name": "Webhook Payloads", "description": "Machine-readable request bodies for the webhook events you can subscribe to via Webhooks Management. These describe the default payload produced by the sample `template` shown on the Create webhook operation — the actual JSON structure sent to your `url` is fully controlled by the `template` you configure, so treat these as suggested defaults rather than a fixed contract." }, { "name": "Signature Key Management", "description": "As a Sinch customer, you want to be able to ensure that webhooks are coming from Sinch and not from a 3rd party. Since \nthese are calls to your own system, you should be provided with an extra level of security \nwhen calling your resources.\n\nThe Sinch Signature Key API provides a number of endpoints \nfor managing key used to sign each unique request to ensure security \nand the requests can't (easily) be spoofed. This is similar to using \nHMAC in your outbound messaging (rather than HTTP Basic).\n\nThe Signature Key API provides seven main endpoints:\n- ```Create signature key``` Create a new signature key for signature verification in webhooks.\n- ```Get signature key detail``` Retrieve the current detail of a signature key using the key_id returned in the ```create signature key``` endpoint.\n- ```Delete signature key``` Delete a signature key using the key_id returned in the ```create signature key``` endpoint.\n- ```Get signature key list``` Retrieve the paginated list of signature keys.\n- ```Enable signature key``` Enable a signature key using the key_id returned in the ```create signature key``` endpoint.\n- ```Get enabled signature key``` Retrieve the current enabled signature key.\n- ```Disable an enabled signature key``` Disable the current enabled signature key.\n" }, { "name": "Contacts", "description": "The API provides access to two main resources:\n\n * **Contacts**: Data associated with the individuals you need to contact.\n * **Lists**: Groups of contacts created for specific purposes.\n * **Custom Fields**: Additional fields that can be tailored to complement the basic contact fields.\n" } ], "externalDocs": { "description": "Agent-readable curated docs index (llms.txt)", "url": "https://developers.app.sinch.com/llms.txt" }, "paths": { "/v2-preview/reporting/messages/metakeys": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Metadata Keys", "description": "Returns a list of metadata keys.", "operationId": "PostMetadataKeys", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/metakeyrequest" } } } }, "responses": { "200": { "description": "A list of metadata keys.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/metakeyresponse" } } } }, "400": { "description": "Bad Request. Check the json response for more details on what went wrong.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"page\": 2,\n \"page_size\": 15,\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v2-preview/reporting/messages/metakeys\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"page\": 2,\n \"page_size\": 15,\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/metakeys\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"page\": 2,\n \"page_size\": 15,\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/metakeys\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"page\": 2,\n \"page_size\": 15,\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/metakeys`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 2,\n 'page_size' => 15,\n 'start_date' => '2022-12-12T00:00:00.000z',\n 'end_date' => '2022-12-14T00:00:00.000z',\n 'direction' => 'all',\n 'accounts' => [\n 'Account1',\n 'Account2'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/messages/metakeys';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"page\": 2,\n \"page_size\": 15,\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/messages/metakeys'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"page\" => 2,\n \"page_size\" => 15,\n \"start_date\" => \"2022-12-12T00:00:00.000z\",\n \"end_date\" => \"2022-12-14T00:00:00.000z\",\n \"direction\" => \"all\",\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/messages/metakeys\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/messages/detail": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Post detail report", "description": "Generates a report listing all sent and/or received messages within a specified time period.", "operationId": "PostDetailReport", "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/detailrequest" } } } }, "responses": { "200": { "description": "A list of all messages received in the specified time window", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/detailresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"timezone\": \"Australia/Sydney\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"mms_media\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"page\": 0,\n \"page_size\": 20\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v2-preview/reporting/messages/detail\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"timezone\": \"Australia/Sydney\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"mms_media\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"page\": 0,\n \"page_size\": 20\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/detail\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"timezone\": \"Australia/Sydney\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"mms_media\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"page\": 0,\n \"page_size\": 20\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/detail\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"timezone\": \"Australia/Sydney\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"mms_media\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"page\": 0,\n \"page_size\": 20\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/detail`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " '2022-12-12T00:00:00.000z',\n 'end_date' => '2022-12-14T00:00:00.000z',\n 'direction' => 'all',\n 'timezone' => 'Australia/Sydney',\n 'source' => '+61555555555',\n 'sources' => [\n '+61555555555',\n '+614987654321'\n ],\n 'destination' => '+61555555555',\n 'destinations' => [\n '+61555555555',\n '+614987654321'\n ],\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'metadata_values' => [\n 'meta1',\n 'meta2'\n ],\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED'\n ],\n 'opt_out' => 'true',\n 'mms_media' => 'true',\n 'message_format' => [\n 'MMS',\n 'TTS'\n ],\n 'channels' => [\n 'SMS',\n 'WHATSAPP'\n ],\n 'page' => 0,\n 'page_size' => 20\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/messages/detail';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"direction\": \"all\",\n \"timezone\": \"Australia/Sydney\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"mms_media\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"page\": 0,\n \"page_size\": 20\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/messages/detail'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\" => \"2022-12-12T00:00:00.000z\",\n \"end_date\" => \"2022-12-14T00:00:00.000z\",\n \"direction\" => \"all\",\n \"timezone\" => \"Australia/Sydney\",\n \"source\" => \"+61555555555\",\n \"sources\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\" => \"+61555555555\",\n \"destinations\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"metadata_values\" => [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\"\n ],\n \"opt_out\" => \"true\",\n \"mms_media\" => \"true\",\n \"message_format\" => [\n \"MMS\",\n \"TTS\"\n ],\n \"channels\" => [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"page\" => 0,\n \"page_size\" => 20\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/messages/detail\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/messages/insights": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Post insight report", "description": "Create report summary containing total number of sent, received and billing units, using pre-calculated data to improve performance.", "operationId": "PostInsightReport", "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/insightsrequest" } } } }, "responses": { "200": { "description": "A list of all messages received in the specified time window", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/insightsresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"start_date\": \"2022-12-12T01:01:01.001z\",\n \"end_date\": \"2022-12-14T01:01:01.001z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"account1\",\n \"account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v2-preview/reporting/messages/insights\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"start_date\": \"2022-12-12T01:01:01.001z\",\n \"end_date\": \"2022-12-14T01:01:01.001z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"account1\",\n \"account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/insights\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"start_date\": \"2022-12-12T01:01:01.001z\",\n \"end_date\": \"2022-12-14T01:01:01.001z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"account1\",\n \"account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/insights\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"start_date\": \"2022-12-12T01:01:01.001z\",\n \"end_date\": \"2022-12-14T01:01:01.001z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"account1\",\n \"account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/insights`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " '2022-12-12T01:01:01.001z',\n 'end_date' => '2022-12-14T01:01:01.001z',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'sources' => [\n '+61555555555',\n '+614987654321'\n ],\n 'destination' => '+61555555555',\n 'destinations' => [\n '+61555555555',\n '+614987654321'\n ],\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'metadata_values' => [\n 'meta1',\n 'meta2'\n ],\n 'accounts' => [\n 'account1',\n 'account2'\n ],\n 'status' => [\n 'DELIVERED',\n 'ENROUTE'\n ],\n 'opt_out' => 'true',\n 'channels' => [\n 'SMS',\n 'WHATSAPP'\n ],\n 'group_by' => [\n 'WEEK',\n 'ACCOUNT'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/messages/insights';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\": \"2022-12-12T01:01:01.001z\",\n \"end_date\": \"2022-12-14T01:01:01.001z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"account1\",\n \"account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"channels\": [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/messages/insights'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\" => \"2022-12-12T01:01:01.001z\",\n \"end_date\" => \"2022-12-14T01:01:01.001z\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"sources\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\" => \"+61555555555\",\n \"destinations\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"metadata_values\" => [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\" => [\n \"account1\",\n \"account2\"\n ],\n \"status\" => [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\" => \"true\",\n \"channels\" => [\n \"SMS\",\n \"WHATSAPP\"\n ],\n \"group_by\" => [\n \"WEEK\",\n \"ACCOUNT\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/messages/insights\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/messages/async/detail": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Post async detail report", "description": "Generates an asynchronous report listing all sent and/or received messages within a specified time period.", "operationId": "PostAsyncDetailReport", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/asyncsentmessagesdetailrequest" } } }, "required": true }, "responses": { "202": { "description": "A list of all messages received in the specified time window", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/asyncreportresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"addresses\": [\n \"+61400000001\",\n \"+61400000002\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"fields\": [\n {\n \"name\": \"id\",\n \"display_name\": \"id\"\n }\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v2-preview/reporting/messages/async/detail\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"addresses\": [\n \"+61400000001\",\n \"+61400000002\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"fields\": [\n {\n \"name\": \"id\",\n \"display_name\": \"id\"\n }\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/async/detail\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"addresses\": [\n \"+61400000001\",\n \"+61400000002\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"fields\": [\n {\n \"name\": \"id\",\n \"display_name\": \"id\"\n }\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/async/detail\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"addresses\": [\n \"+61400000001\",\n \"+61400000002\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"fields\": [\n {\n \"name\": \"id\",\n \"display_name\": \"id\"\n }\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/async/detail`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " '2022-12-12T00:00:00.000z',\n 'end_date' => '2022-12-14T00:00:00.000z',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'sources' => [\n '+61555555555',\n '+614987654321'\n ],\n 'destination' => '+61555555555',\n 'destinations' => [\n '+61555555555',\n '+614987654321'\n ],\n 'addresses' => [\n '+61400000001',\n '+61400000002'\n ],\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'metadata_values' => [\n 'meta1',\n 'meta2'\n ],\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED'\n ],\n 'opt_out' => 'true',\n 'message_format' => [\n 'MMS',\n 'TTS'\n ],\n 'fields' => [\n [\n 'name' => 'id',\n 'display_name' => 'id'\n ]\n ],\n 'delivery_options' => [\n [\n 'delivery_type' => 'EMAIL',\n 'delivery_addresses' => [\n 'email@example.com',\n 'test@example.com'\n ],\n 'delivery_format' => 'CSV'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/messages/async/detail';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"addresses\": [\n \"+61400000001\",\n \"+61400000002\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"message_format\": [\n \"MMS\",\n \"TTS\"\n ],\n \"fields\": [\n {\n \"name\": \"id\",\n \"display_name\": \"id\"\n }\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/messages/async/detail'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\" => \"2022-12-12T00:00:00.000z\",\n \"end_date\" => \"2022-12-14T00:00:00.000z\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"sources\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\" => \"+61555555555\",\n \"destinations\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"addresses\" => [\n \"+61400000001\",\n \"+61400000002\"\n ],\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"metadata_values\" => [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\"\n ],\n \"opt_out\" => \"true\",\n \"message_format\" => [\n \"MMS\",\n \"TTS\"\n ],\n \"fields\" => [\n {\n \"name\" => \"id\",\n \"display_name\" => \"id\"\n }\n ],\n \"delivery_options\" => [\n {\n \"delivery_type\" => \"EMAIL\",\n \"delivery_addresses\" => [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\" => \"CSV\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/messages/async/detail\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/messages/async/summary": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Post async summary report", "description": "Creates an asynchronous report summary containing total number of sent, received and billing units.", "operationId": "PostAsyncSummaryReport", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/asyncsummaryrequest" } } } }, "responses": { "202": { "description": "A list of all messages received in the specified time window", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/asyncreportresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"false\",\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v2-preview/reporting/messages/async/summary\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"false\",\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/async/summary\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"false\",\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/async/summary\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"false\",\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/async/summary`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " '2022-12-12T00:00:00.000z',\n 'end_date' => '2022-12-14T00:00:00.000z',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'sources' => [\n '+61555555555',\n '+614987654321'\n ],\n 'destination' => '+61555555555',\n 'destinations' => [\n '+61555555555',\n '+614987654321'\n ],\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'metadata_values' => [\n 'meta1',\n 'meta2'\n ],\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED'\n ],\n 'opt_out' => 'false',\n 'group_by' => [\n 'WEEK',\n 'ACCOUNT'\n ],\n 'delivery_options' => [\n [\n 'delivery_type' => 'EMAIL',\n 'delivery_addresses' => [\n 'email@example.com',\n 'test@example.com'\n ],\n 'delivery_format' => 'CSV'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/messages/async/summary';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\": \"2022-12-12T00:00:00.000z\",\n \"end_date\": \"2022-12-14T00:00:00.000z\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"sources\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\": \"+61555555555\",\n \"destinations\": [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"metadata_values\": [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"false\",\n \"group_by\": [\n \"WEEK\",\n \"ACCOUNT\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/messages/async/summary'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"start_date\" => \"2022-12-12T00:00:00.000z\",\n \"end_date\" => \"2022-12-14T00:00:00.000z\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"sources\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"destination\" => \"+61555555555\",\n \"destinations\" => [\n \"+61555555555\",\n \"+614987654321\"\n ],\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"metadata_values\" => [\n \"meta1\",\n \"meta2\"\n ],\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\"\n ],\n \"opt_out\" => \"false\",\n \"group_by\" => [\n \"WEEK\",\n \"ACCOUNT\"\n ],\n \"delivery_options\" => [\n {\n \"delivery_type\" => \"EMAIL\",\n \"delivery_addresses\" => [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\" => \"CSV\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/messages/async/summary\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/messages/async/status": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Get async detail report status", "description": "Retrieves the status of a detail report.", "operationId": "GetAsyncDetailStatus", "parameters": [ { "name": "report_id", "in": "query", "description": "The ID of the detail report to retrieve.", "required": true, "style": "form", "explode": true, "schema": { "type": "string", "example": "abc" } } ], "responses": { "200": { "description": "The status of the requested detail report.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/reportstatusresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nREPORT_ID=\"YOUR_REPORT_ID\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v2-preview/reporting/messages/async/status?report_id=${REPORT_ID}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var reportId = \"YOUR_REPORT_ID\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/async/status?report_id={reportId}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String reportId = \"YOUR_REPORT_ID\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/async/status\" + \"?\" + \"report_id=\" + reportId;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst reportId = 'YOUR_REPORT_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/async/status?report_id=${reportId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"page\": 1,\n \"page_size\": 50,\n \"start_date\": \"2020-05-28T10:27:46.259Z\",\n \"end_date\": \"2020-06-28T10:27:46.259Z\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/async/detail/fields`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 1,\n 'page_size' => 50,\n 'start_date' => '2020-05-28T10:27:46.259Z',\n 'end_date' => '2020-06-28T10:27:46.259Z'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/messages/async/detail/fields';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"page\": 1,\n \"page_size\": 50,\n \"start_date\": \"2020-05-28T10:27:46.259Z\",\n \"end_date\": \"2020-06-28T10:27:46.259Z\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/messages/async/detail/fields'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"page\" => 1,\n \"page_size\" => 50,\n \"start_date\" => \"2020-05-28T10:27:46.259Z\",\n \"end_date\" => \"2020-06-28T10:27:46.259Z\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/messages/async/detail/fields\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/messages/async/reports": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] }, { "bearer_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Get async report history", "description": "Returns a list of asynchronous reports that have been requested by the current account.", "operationId": "GetAsyncReportHistory", "parameters": [ { "name": "page_size", "in": "query", "description": "The number of items to return per page.", "required": false, "style": "form", "explode": true, "schema": { "type": "integer", "example": 10 } }, { "name": "page_token", "in": "query", "description": "A pagination token returned from a previous call. Pass this to retrieve the next page of results.", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "example": "eyJyZXBvcnRJZCI6IjUxZjAwOTdmLTkwYjItNGE1OS1hZDg4LWEwZmQ5M2FiYWE4MiJ9" } }, { "name": "report_name", "in": "query", "description": "Filter results by report name.", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "example": "My Detail Report" } }, { "name": "status", "in": "query", "description": "Filter results by report status. Multiple statuses can be specified.", "required": false, "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "REQUESTED", "RUNNING", "FAILED", "CANCELLED", "DONE" ] } } }, { "name": "start_date", "in": "query", "description": "Filter reports requested on or after this date (ISO 8601).", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "format": "date-time", "example": "2020-05-28T10:27:46.259Z" } }, { "name": "end_date", "in": "query", "description": "Filter reports requested on or before this date (ISO 8601).", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "format": "date-time", "example": "2020-06-28T10:27:46.259Z" } }, { "name": "sort_direction", "in": "query", "description": "Sort direction for the results.", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "enum": [ "ASCENDING", "DESCENDING" ], "example": "DESCENDING" } } ], "responses": { "200": { "description": "A list of async reports for the current account.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/reporthistoryresponses" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nPAGE_SIZE=\"0\"\nPAGE_TOKEN=\"YOUR_PAGE_TOKEN\"\nREPORT_NAME=\"YOUR_REPORT_NAME\"\nSTATUS=\"YOUR_STATUS\"\nSTART_DATE=\"YOUR_START_DATE\"\nEND_DATE=\"YOUR_END_DATE\"\nSORT_DIRECTION=\"YOUR_SORT_DIRECTION\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v2-preview/reporting/messages/async/reports?page_size=${PAGE_SIZE}&page_token=${PAGE_TOKEN}&report_name=${REPORT_NAME}&status=${STATUS}&start_date=${START_DATE}&end_date=${END_DATE}&sort_direction=${SORT_DIRECTION}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var pageSize = 0;\n var pageToken = \"YOUR_PAGE_TOKEN\";\n var reportName = \"YOUR_REPORT_NAME\";\n var status = \"YOUR_STATUS\";\n var startDate = \"YOUR_START_DATE\";\n var endDate = \"YOUR_END_DATE\";\n var sortDirection = \"YOUR_SORT_DIRECTION\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/messages/async/reports?page_size={pageSize}&page_token={pageToken}&report_name={reportName}&status={status}&start_date={startDate}&end_date={endDate}&sort_direction={sortDirection}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n int pageSize = 0;\n String pageToken = \"YOUR_PAGE_TOKEN\";\n String reportName = \"YOUR_REPORT_NAME\";\n String status = \"YOUR_STATUS\";\n String startDate = \"YOUR_START_DATE\";\n String endDate = \"YOUR_END_DATE\";\n String sortDirection = \"YOUR_SORT_DIRECTION\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/messages/async/reports\" + \"?\" + \"page_size=\" + pageSize + \"&\" + \"page_token=\" + pageToken + \"&\" + \"report_name=\" + reportName + \"&\" + \"status=\" + status + \"&\" + \"start_date=\" + startDate + \"&\" + \"end_date=\" + endDate + \"&\" + \"sort_direction=\" + sortDirection;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst pageSize = 0;\nconst pageToken = 'YOUR_PAGE_TOKEN';\nconst reportName = 'YOUR_REPORT_NAME';\nconst status = 'YOUR_STATUS';\nconst startDate = 'YOUR_START_DATE';\nconst endDate = 'YOUR_END_DATE';\nconst sortDirection = 'YOUR_SORT_DIRECTION';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/async/reports?page_size=${pageSize}&page_token=${pageToken}&report_name=${reportName}&status=${status}&start_date=${startDate}&end_date=${endDate}&sort_direction=${sortDirection}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst reportId = 'YOUR_REPORT_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/messages/async/reports/${reportId}/download-url`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/detail/scheduled`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Weekly Report',\n 'schedule' => [\n 'timezone' => 'UTC',\n 'cron_expression' => '0 0 * * * ? *',\n 'type' => 'cron'\n ],\n 'report' => [\n 'period' => 'THIS_WEEK',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'destination' => '+61555555555',\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED'\n ],\n 'opt_out' => 'true',\n 'delivery_options' => [\n [\n 'delivery_type' => 'EMAIL',\n 'delivery_addresses' => [\n 'email@example.com',\n 'test@example.com'\n ],\n 'delivery_format' => 'CSV'\n ]\n ]\n ],\n 'metadata' => [\n [\n 'key' => 'myKey',\n 'value' => 'myValue'\n ],\n [\n 'key' => 'anotherKey',\n 'value' => 'anotherValue'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/detail/scheduled';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/detail/scheduled'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"label\" => \"Weekly Report\",\n \"schedule\" => {\n \"timezone\" => \"UTC\",\n \"cron_expression\" => \"0 0 * * * ? *\",\n \"type\" => \"cron\"\n },\n \"report\" => {\n \"period\" => \"THIS_WEEK\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"destination\" => \"+61555555555\",\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\"\n ],\n \"opt_out\" => \"true\",\n \"delivery_options\" => [\n {\n \"delivery_type\" => \"EMAIL\",\n \"delivery_addresses\" => [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\" => \"CSV\"\n }\n ]\n },\n \"metadata\" => [\n {\n \"key\" => \"myKey\",\n \"value\" => \"myValue\"\n },\n {\n \"key\" => \"anotherKey\",\n \"value\" => \"anotherValue\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/detail/scheduled\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/detail/scheduled/{id}": { "put": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Update a scheduled detail report", "description": "Updates a selected scheduled report in detail, which contains a total number of sent, received and billing units.", "operationId": "updatedetailscheduledreport", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The ID of the scheduled report to update.", "example": "e6fb8282-c7c3-4367-8590-6c77ddb11c3e" } ], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updatescheduleddetailreport" } } }, "required": true }, "responses": { "200": { "description": "The updated scheduled detail report.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scheduleddetailreportresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nSCHEDULED_ID=\"YOUR_SCHEDULED_ID\"\n\nBODY=$(cat <<'EOF'\n{\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X PUT \"${API_HOST}/v2-preview/reporting/detail/scheduled/${SCHEDULED_ID}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var scheduledId = \"YOUR_SCHEDULED_ID\";\n\n var body = \"\"\"\n {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/detail/scheduled/{scheduledId}\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PutAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String scheduledId = \"YOUR_SCHEDULED_ID\";\n\n String body = \"\"\"\n {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/detail/scheduled/\" + scheduledId;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"PUT\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst scheduledId = 'YOUR_SCHEDULED_ID';\n\nconst body = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/detail/scheduled/${scheduledId}`, {\n method: 'PUT',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Weekly Report',\n 'schedule' => [\n 'timezone' => 'UTC',\n 'cron_expression' => '0 0 * * * ? *',\n 'type' => 'cron'\n ],\n 'report' => [\n 'period' => 'THIS_WEEK',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'destination' => '+61555555555',\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED'\n ],\n 'opt_out' => 'true',\n 'delivery_options' => [\n [\n 'delivery_type' => 'EMAIL',\n 'delivery_addresses' => [\n 'email@example.com',\n 'test@example.com'\n ],\n 'delivery_format' => 'CSV'\n ]\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/detail/scheduled/' . $scheduledId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nscheduled_id = \"YOUR_SCHEDULED_ID\"\n\nbody = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\"\n ],\n \"opt_out\": \"true\",\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/detail/scheduled/{scheduled_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PUT')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nscheduled_id = \"YOUR_SCHEDULED_ID\"\n\nbody = {\n \"label\" => \"Weekly Report\",\n \"schedule\" => {\n \"timezone\" => \"UTC\",\n \"cron_expression\" => \"0 0 * * * ? *\",\n \"type\" => \"cron\"\n },\n \"report\" => {\n \"period\" => \"THIS_WEEK\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"destination\" => \"+61555555555\",\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\"\n ],\n \"opt_out\" => \"true\",\n \"delivery_options\" => [\n {\n \"delivery_type\" => \"EMAIL\",\n \"delivery_addresses\" => [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\" => \"CSV\"\n }\n ]\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/detail/scheduled/#{scheduled_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Put.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/summary/scheduled": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Scheduled summary report", "description": "Create scheduled report summary containing total number of sent, received and billing units.", "operationId": "summaryscheduledreport", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scheduledsummaryreport" } } }, "required": true }, "responses": { "201": { "description": "A scheduled summary report received using the specified parameters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scheduledreportresponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v2-preview/reporting/summary/scheduled\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/summary/scheduled\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/summary/scheduled\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/summary/scheduled`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Weekly Report',\n 'schedule' => [\n 'timezone' => 'UTC',\n 'cron_expression' => '0 0 * * * ? *',\n 'type' => 'cron'\n ],\n 'report' => [\n 'period' => 'THIS_WEEK',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'destination' => '+61555555555',\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED',\n 'ENROUTE'\n ],\n 'opt_out' => 'true',\n 'group_by' => [\n 'DAY',\n 'WEEK'\n ],\n 'delivery_options' => [\n [\n 'delivery_type' => 'EMAIL',\n 'delivery_addresses' => [\n 'email@example.com',\n 'test@example.com'\n ],\n 'delivery_format' => 'CSV'\n ]\n ]\n ],\n 'metadata' => [\n [\n 'key' => 'myKey',\n 'value' => 'myValue'\n ],\n [\n 'key' => 'anotherKey',\n 'value' => 'anotherValue'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/summary/scheduled';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n },\n \"metadata\": [\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/summary/scheduled'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"label\" => \"Weekly Report\",\n \"schedule\" => {\n \"timezone\" => \"UTC\",\n \"cron_expression\" => \"0 0 * * * ? *\",\n \"type\" => \"cron\"\n },\n \"report\" => {\n \"period\" => \"THIS_WEEK\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"destination\" => \"+61555555555\",\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\" => \"true\",\n \"group_by\" => [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\" => [\n {\n \"delivery_type\" => \"EMAIL\",\n \"delivery_addresses\" => [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\" => \"CSV\"\n }\n ]\n },\n \"metadata\" => [\n {\n \"key\" => \"myKey\",\n \"value\" => \"myValue\"\n },\n {\n \"key\" => \"anotherKey\",\n \"value\" => \"anotherValue\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/summary/scheduled\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/summary/scheduled/{id}": { "put": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Update a scheduled summary report", "description": "Updates a selected scheduled report summary, which contains a total number of sent, received and billing units.", "operationId": "updatesummaryscheduledreport", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The ID of the scheduled report to update.", "example": "e6fb8282-c7c3-4367-8590-6c77ddb11c3e" } ], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updatescheduledsummaryreport" } } }, "required": true }, "responses": { "200": { "description": "The updated scheduled summary report.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scheduledsummaryreportresposne" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nSCHEDULED_ID=\"YOUR_SCHEDULED_ID\"\n\nBODY=$(cat <<'EOF'\n{\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X PUT \"${API_HOST}/v2-preview/reporting/summary/scheduled/${SCHEDULED_ID}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var scheduledId = \"YOUR_SCHEDULED_ID\";\n\n var body = \"\"\"\n {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/summary/scheduled/{scheduledId}\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PutAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String scheduledId = \"YOUR_SCHEDULED_ID\";\n\n String body = \"\"\"\n {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/summary/scheduled/\" + scheduledId;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"PUT\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst scheduledId = 'YOUR_SCHEDULED_ID';\n\nconst body = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/summary/scheduled/${scheduledId}`, {\n method: 'PUT',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Weekly Report',\n 'schedule' => [\n 'timezone' => 'UTC',\n 'cron_expression' => '0 0 * * * ? *',\n 'type' => 'cron'\n ],\n 'report' => [\n 'period' => 'THIS_WEEK',\n 'timezone' => 'Australia/Sydney',\n 'direction' => 'all',\n 'source' => '+61555555555',\n 'destination' => '+61555555555',\n 'metadata_key' => 'broadcastId',\n 'metadata_value' => 'ABC',\n 'accounts' => [\n 'Account1',\n 'Account2'\n ],\n 'status' => [\n 'DELIVERED',\n 'ENROUTE'\n ],\n 'opt_out' => 'true',\n 'group_by' => [\n 'DAY',\n 'WEEK'\n ],\n 'delivery_options' => [\n [\n 'delivery_type' => 'EMAIL',\n 'delivery_addresses' => [\n 'email@example.com',\n 'test@example.com'\n ],\n 'delivery_format' => 'CSV'\n ]\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v2-preview/reporting/summary/scheduled/' . $scheduledId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nscheduled_id = \"YOUR_SCHEDULED_ID\"\n\nbody = {\n \"label\": \"Weekly Report\",\n \"schedule\": {\n \"timezone\": \"UTC\",\n \"cron_expression\": \"0 0 * * * ? *\",\n \"type\": \"cron\"\n },\n \"report\": {\n \"period\": \"THIS_WEEK\",\n \"timezone\": \"Australia/Sydney\",\n \"direction\": \"all\",\n \"source\": \"+61555555555\",\n \"destination\": \"+61555555555\",\n \"metadata_key\": \"broadcastId\",\n \"metadata_value\": \"ABC\",\n \"accounts\": [\n \"Account1\",\n \"Account2\"\n ],\n \"status\": [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\": \"true\",\n \"group_by\": [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\": [\n {\n \"delivery_type\": \"EMAIL\",\n \"delivery_addresses\": [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\": \"CSV\"\n }\n ]\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v2-preview/reporting/summary/scheduled/{scheduled_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PUT')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nscheduled_id = \"YOUR_SCHEDULED_ID\"\n\nbody = {\n \"label\" => \"Weekly Report\",\n \"schedule\" => {\n \"timezone\" => \"UTC\",\n \"cron_expression\" => \"0 0 * * * ? *\",\n \"type\" => \"cron\"\n },\n \"report\" => {\n \"period\" => \"THIS_WEEK\",\n \"timezone\" => \"Australia/Sydney\",\n \"direction\" => \"all\",\n \"source\" => \"+61555555555\",\n \"destination\" => \"+61555555555\",\n \"metadata_key\" => \"broadcastId\",\n \"metadata_value\" => \"ABC\",\n \"accounts\" => [\n \"Account1\",\n \"Account2\"\n ],\n \"status\" => [\n \"DELIVERED\",\n \"ENROUTE\"\n ],\n \"opt_out\" => \"true\",\n \"group_by\" => [\n \"DAY\",\n \"WEEK\"\n ],\n \"delivery_options\" => [\n {\n \"delivery_type\" => \"EMAIL\",\n \"delivery_addresses\" => [\n \"email@example.com\",\n \"test@example.com\"\n ],\n \"delivery_format\" => \"CSV\"\n }\n ]\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v2-preview/reporting/summary/scheduled/#{scheduled_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Put.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v2-preview/reporting/scheduled": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messaging Reports" ], "summary": "Get active reports", "description": "Retrieves all ACTIVE scheduled reports of a provided account.", "operationId": "GetActiveReport", "parameters": [ { "name": "page_size", "in": "query", "description": "Number of results to return in a page for paginated result sets.", "style": "form", "explode": true, "schema": { "type": "number", "example": 20, "minimum": 1, "maximum": 100 } }, { "name": "page_token", "in": "query", "description": "Returned by Chronos service", "schema": { "type": "string", "example": "eyJwYWdlIjoyfQ" } } ], "responses": { "200": { "description": "A list of all messages received in the specified time window", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/chronosscheduleresponse" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "description": "Scheduled report not found." } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nPAGE_SIZE=\"0\"\nPAGE_TOKEN=\"YOUR_PAGE_TOKEN\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v2-preview/reporting/scheduled?page_size=${PAGE_SIZE}&page_token=${PAGE_TOKEN}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var pageSize = 0;\n var pageToken = \"YOUR_PAGE_TOKEN\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v2-preview/reporting/scheduled?page_size={pageSize}&page_token={pageToken}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n double pageSize = 0d;\n String pageToken = \"YOUR_PAGE_TOKEN\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v2-preview/reporting/scheduled\" + \"?\" + \"page_size=\" + pageSize + \"&\" + \"page_token=\" + pageToken;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst pageSize = 0;\nconst pageToken = 'YOUR_PAGE_TOKEN';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/scheduled?page_size=${pageSize}&page_token=${pageToken}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst scheduledId = 'YOUR_SCHEDULED_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/scheduled/${scheduledId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst scheduledId = 'YOUR_SCHEDULED_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v2-preview/reporting/scheduled/${scheduledId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst messageId = 'YOUR_MESSAGE_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messages/${messageId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst messageId = 'YOUR_MESSAGE_ID';\n\nconst body = {\n \"status\": \"cancelled\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messages/${messageId}`, {\n method: 'PUT',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'cancelled'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messages/' . $messageId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nmessage_id = \"YOUR_MESSAGE_ID\"\n\nbody = {\n \"status\": \"cancelled\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messages/{message_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PUT')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nmessage_id = \"YOUR_MESSAGE_ID\"\n\nbody = {\n \"status\" => \"cancelled\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messages/#{message_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Put.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/messages": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Messages" ], "summary": "Send messages", "description": "Submit one or more (up to 100 per request) SMS, MMS or text to voice\nmessages for delivery.\n\nThe most basic message has the following structure:\n\n```javascript\n\n{\n \"messages\": [\n {\n \"content\": \"My first message!\",\n \"destination_number\": \"+61491570156\"\n }\n ]\n}\n\n```\n\nMore advanced delivery features can be specified by setting the\nfollowing properties in a message:\n\n- ```callback_url``` A URL can be included with each message to which\nWebhooks will be pushed to via a HTTP POST request. Webhooks will be sent if and when the status of the message changes as it is processed (if the delivery report property of the request is set to ```true```) and when replies are received. Specifying a callback URL is optional. When provided, the URL must use the ```http``` or ```https``` scheme, the hostname must conform to RFC 1123 DNS name syntax, and the path must not contain whitespace or control characters. Malformed values (for example ```https://-invalid.com```, ```https://invalid_.com```, ```https:///path```, ```https://:/path```, ```http://.example.com```, ```http://example..com```, or a path containing spaces) are rejected with HTTP 400. If any message in a multi-message request has an invalid ```callback_url```, no messages are sent.\n\n- ```content``` The content of the message. This can be a Unicode string, up to 5,000 characters long.\n Message content is required.\n\n- ```delivery_report``` Delivery reports can be requested with each\nmessage. If delivery reports are requested, a webhook will be submitted to the ```callback_url``` property specified for the message (or to the webhooks)\n specified for the account every time the status of the message changes as it is processed. The\n current status of the message can also be retrieved via the Delivery Reports endpoint of the\n Messages API. Delivery reports are optional and by default will not be requested.\n\n- ```destination_number``` The destination number the message should be\ndelivered to. This should be specified in E.164\n international format. For information on E.164, please refer to http://en.wikipedia.org/wiki/E.164.\n A destination number is required. \n⚠️ IMDA TLS Compliance Notice: From 1 April 2026, all requests sending messages to Singapore (+65) numbers must use TLS 1.3 or higher. Requests using an older TLS version will be rejected with HTTP 422 Unprocessable Entity.\n\n- ```format``` The format specifies which format the message will be\nsent as, ```SMS``` (text message), ```MMS``` (multimedia message)\n or ```TTS``` (text to speech). With ```TTS``` format, we will call the destination number and read out the\n message using a computer generated voice. Specifying a format is optional, by default ```SMS``` will be used.\n\n- ```source_number_type``` If a source number is specified, the type of\nsource number may also be\n specified. This is recommended when using a source address type that is not an internationally\n formatted number, available options are ```INTERNATIONAL```, ```ALPHANUMERIC``` or ```SHORTCODE```. Specifying a\n source number type is only valid when the ```source_number``` parameter is specified and is optional.\n If a source number is specified and no source number type is specified, the source number type will be\n inferred from the source number, however this may be inaccurate.\n\n- ```source_number```[optional] Specify a source number to be used. Refer to the section below for more information on source numbers. \n⚠️ The number or sender ID must be registered to your account (from 1-Mar-2024).\n\n #### Source number (sender ID)\n \n There are several options for the number or sender ID that will show as the source of an outbound message. Some things to note:\n - If you do not specify a source number, the message will be sent with the default number for your account.\n - The default may be a number you have purchased from us - such as a dedicated number, a 10-digit longcode or toll-free number (US/CA), or a shortcode. Log into the web portal to manage your numbers.\n - If your account has multiple numbers, you can specify which source number to use in the request.\n - If your account does not have a number, your message may be sent using our shared number pool (in certain countries only)\n - `Alpha tag:` In some countries (AU, GB, some others), you may be able to send using an alpha tag - text that represents your brand of business. Before using an alpha tag, you must register it in the Numbers section of the web portal.\n - `Other numbers:` You may use numbers that you own as the source number, but you must register them in the Numbers section of the web portal to confirm you have a right to use the number.\n If you need to register a large number of source numbers/sender IDs, consider using our [Source Address API](#tag/Source-Address)\n \n ⚠️ If you specify a source_number that is not registered to your account, the message may fail to send, or may be sent with an alternative number.\n\n- ```media``` The media is used to specify a list of URLs of the media file(s) that you are trying to send. \nSupported file formats include png, jpeg and gif. ```format``` parameter must be set to ```MMS``` for this to\nwork.\n\n- ```subject``` The subject field is used to denote subject of the MMS\nmessage and has a maximum size of 64 characters long. Specifying a\nsubject is optional.\n\n- ```scheduled``` A message can be scheduled for delivery in the future\nby setting the scheduled property.\n The scheduled property expects a date time specified in ISO 8601 format. The scheduled time must be\n provided in UTC and is optional. If no scheduled property is set, the message will be delivered immediately.\n\n- ```message_expiry_timestamp``` A message expiry timestamp can be\nprovided to specify the latest time\n at which the message should be delivered. If the message cannot be delivered before the specified\n message expiry timestamp elapses, the message will be discarded. Specifying a message expiry \n timestamp is optional.\n\n- ```metadata``` Metadata can be included with the message which will\nthen be included with any delivery\n reports or replies matched to the message. This can be used to create powerful two-way messaging\n applications without having to store persistent data in the application. Up to 10 key / value metadata data\n pairs can be specified in a message. Each key can be up to 100 characters long, and each value up to \n 256 characters long. Specifying metadata for a message is optional.\n\nThe response body of a successful POST request to the messages endpoint\nwill include a ```messages``` property which contains a list of all messages submitted. The list of\nmessages submitted will reflect the list of messages included in the request, but each message\nwill also contain two new properties, ```message_id``` and ```status```. The returned message ID\nwill be a 36 character UUID which can be used to check the status of the message via the Get Message\nStatus endpoint. The status of the message which reflect the status of the message at submission\ntime which will always be ```queued```. See the Delivery Reports section of this documentation for\nmore information on message statuses.\n\n*Note: when sending multiple messages in a request, all messages must be valid for the request \nto be successful. If any messages in the request are invalid, no messages will be sent.*\n", "operationId": "SendMessages", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Sendmessagesrequest" }, "example": { "messages": [ { "callback_url": "https://my.callback.url.com", "content": "My first message", "destination_number": "+61491570156", "delivery_report": true, "format": "SMS", "message_expiry_timestamp": "2016-11-03T11:49:02.807Z", "metadata": { "key1": "value1", "key2": "value2" }, "scheduled": "2016-11-03T11:49:02.807Z", "source_number": "+61491570157", "source_number_type": "INTERNATIONAL" }, { "callback_url": "https://my.callback.url.com", "content": "My second message", "destination_number": "+61491570158", "delivery_report": true, "format": "MMS", "subject": "This is an MMS message", "media": [ "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg" ], "message_expiry_timestamp": "2016-11-03T11:49:02.807Z", "metadata": { "key1": "value1", "key2": "value2" }, "scheduled": "2016-11-03T11:49:02.807Z", "source_number": "+61491570159", "source_number_type": "INTERNATIONAL" } ] } } }, "required": true }, "responses": { "202": { "description": "Messages were accepted for processing", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Sendmessagesresponse" } } } }, "400": { "description": "Unexpected error in API call. See HTTP response body for details. Returned when the request fails to parse or message fields are invalid, including a malformed per-message `callback_url` (unsupported scheme, malformed hostname or DNS syntax, or path containing whitespace or control characters). If any message in a multi-message request is invalid, no messages are sent.\n", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" }, "examples": { "invalidDestinationNumber": { "summary": "Invalid destination number", "value": { "message": "Request failed to parse correctly. Please ensure input is valid and try again.", "details": [ "/messages/0/destination_number: International address must be between 8 and 15 characters excluding the first '+', International address contains invalid characters." ] } }, "invalidCallbackUrl": { "summary": "Invalid callback URL", "value": { "message": "Request failed to parse correctly. Please ensure input is valid and try again.", "details": [ "/messages/0/callbackUrl: Invalid callback url" ] } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"messages\": [\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My first message\",\n \"destination_number\": \"+61491570156\",\n \"delivery_report\": true,\n \"format\": \"SMS\",\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570157\",\n \"source_number_type\": \"INTERNATIONAL\"\n },\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My second message\",\n \"destination_number\": \"+61491570158\",\n \"delivery_report\": true,\n \"format\": \"MMS\",\n \"subject\": \"This is an MMS message\",\n \"media\": [\n \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\"\n ],\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570159\",\n \"source_number_type\": \"INTERNATIONAL\"\n }\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v1/messages\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"messages\": [\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My first message\",\n \"destination_number\": \"+61491570156\",\n \"delivery_report\": true,\n \"format\": \"SMS\",\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570157\",\n \"source_number_type\": \"INTERNATIONAL\"\n },\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My second message\",\n \"destination_number\": \"+61491570158\",\n \"delivery_report\": true,\n \"format\": \"MMS\",\n \"subject\": \"This is an MMS message\",\n \"media\": [\n \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\"\n ],\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570159\",\n \"source_number_type\": \"INTERNATIONAL\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/messages\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"messages\": [\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My first message\",\n \"destination_number\": \"+61491570156\",\n \"delivery_report\": true,\n \"format\": \"SMS\",\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570157\",\n \"source_number_type\": \"INTERNATIONAL\"\n },\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My second message\",\n \"destination_number\": \"+61491570158\",\n \"delivery_report\": true,\n \"format\": \"MMS\",\n \"subject\": \"This is an MMS message\",\n \"media\": [\n \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\"\n ],\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570159\",\n \"source_number_type\": \"INTERNATIONAL\"\n }\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/messages\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"messages\": [\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My first message\",\n \"destination_number\": \"+61491570156\",\n \"delivery_report\": true,\n \"format\": \"SMS\",\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570157\",\n \"source_number_type\": \"INTERNATIONAL\"\n },\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My second message\",\n \"destination_number\": \"+61491570158\",\n \"delivery_report\": true,\n \"format\": \"MMS\",\n \"subject\": \"This is an MMS message\",\n \"media\": [\n \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\"\n ],\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570159\",\n \"source_number_type\": \"INTERNATIONAL\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messages`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n [\n 'callback_url' => 'https://my.callback.url.com',\n 'content' => 'My first message',\n 'destination_number' => '+61491570156',\n 'delivery_report' => true,\n 'format' => 'SMS',\n 'message_expiry_timestamp' => '2016-11-03T11:49:02.807Z',\n 'metadata' => [\n 'key1' => 'value1',\n 'key2' => 'value2'\n ],\n 'scheduled' => '2016-11-03T11:49:02.807Z',\n 'source_number' => '+61491570157',\n 'source_number_type' => 'INTERNATIONAL'\n ],\n [\n 'callback_url' => 'https://my.callback.url.com',\n 'content' => 'My second message',\n 'destination_number' => '+61491570158',\n 'delivery_report' => true,\n 'format' => 'MMS',\n 'subject' => 'This is an MMS message',\n 'media' => [\n 'https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg'\n ],\n 'message_expiry_timestamp' => '2016-11-03T11:49:02.807Z',\n 'metadata' => [\n 'key1' => 'value1',\n 'key2' => 'value2'\n ],\n 'scheduled' => '2016-11-03T11:49:02.807Z',\n 'source_number' => '+61491570159',\n 'source_number_type' => 'INTERNATIONAL'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messages';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"messages\": [\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My first message\",\n \"destination_number\": \"+61491570156\",\n \"delivery_report\": True,\n \"format\": \"SMS\",\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570157\",\n \"source_number_type\": \"INTERNATIONAL\"\n },\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"content\": \"My second message\",\n \"destination_number\": \"+61491570158\",\n \"delivery_report\": True,\n \"format\": \"MMS\",\n \"subject\": \"This is an MMS message\",\n \"media\": [\n \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\"\n ],\n \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"scheduled\": \"2016-11-03T11:49:02.807Z\",\n \"source_number\": \"+61491570159\",\n \"source_number_type\": \"INTERNATIONAL\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messages'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"messages\" => [\n {\n \"callback_url\" => \"https://my.callback.url.com\",\n \"content\" => \"My first message\",\n \"destination_number\" => \"+61491570156\",\n \"delivery_report\" => true,\n \"format\" => \"SMS\",\n \"message_expiry_timestamp\" => \"2016-11-03T11:49:02.807Z\",\n \"metadata\" => {\n \"key1\" => \"value1\",\n \"key2\" => \"value2\"\n },\n \"scheduled\" => \"2016-11-03T11:49:02.807Z\",\n \"source_number\" => \"+61491570157\",\n \"source_number_type\" => \"INTERNATIONAL\"\n },\n {\n \"callback_url\" => \"https://my.callback.url.com\",\n \"content\" => \"My second message\",\n \"destination_number\" => \"+61491570158\",\n \"delivery_report\" => true,\n \"format\" => \"MMS\",\n \"subject\" => \"This is an MMS message\",\n \"media\" => [\n \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\"\n ],\n \"message_expiry_timestamp\" => \"2016-11-03T11:49:02.807Z\",\n \"metadata\" => {\n \"key1\" => \"value1\",\n \"key2\" => \"value2\"\n },\n \"scheduled\" => \"2016-11-03T11:49:02.807Z\",\n \"source_number\" => \"+61491570159\",\n \"source_number_type\" => \"INTERNATIONAL\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messages\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/messaging/numbers/sender_address/requests": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Source Address" ], "summary": "Request a Sender Address", "description": "Submit a **sender address request** to register a new Sender ID.\n\nThe `id` in the response is the **request** UUID. Use it only with request endpoints (get status, submit verification code). It is **not** the approved sender address UUID. After approval, use **Get all approved sender addresses** to get the address `id` needed to delete or manage the sender.\n\nWhen making a request to this endpoint, you will always need to specify ```sender_address_type``` and ```usage_type``` parameters. The following table shows the acceptable values and combinations for these parameters:\n | Sender ID | sender_address_type | usage_type |\n |--- |--- |--- |\n | Alpha tag | `ALPHANUMERIC` | `ALPHANUMERIC` |\n | Personal number | `INTERNATIONAL` | `OWN_NUMBER` | \n\nThe other parameters required for your request will depend on the type of Sender ID you are registering.\n\n### Sender ID is an Alpha Tag\nThe following parameters are used when registering an alpha tag as a Sender ID:\n - ```sender_address:``` **(Required)**. The alphanumeric string that you wish register as an alpha tag. This parameter is case insensitive. If this alpha tag already exists on your account, you will receive a conflict error message.\n - ```destination_countries:``` **(Required)**. The countries that you wish to register the alpha tag for use in, in two-character ISO 3166 format. Currently AD, AI, AL, AS, AT, AW, BA, BB, BH, BW, CD, CH, CK, CY, DE, DJ, DK, DM, EE, ES, FI, FJ, FM, FO, FR, GB, GD, GG, GI, GL, GM, GQ, GR, GY, IL, IM, IS, JE, JM, JP, KI, KY, LA, LI, LS, LT, LU, LV, MC, ME, MH, MO, MR, MS, MT, MV, NC, NF, NL, NO, NR, NU, PF, PM, PT, SB, SC, SE, SH, SL, SM, ST, TC, TD, TO, VC, VG and WS are supported.\n - ```sender_address_type:``` **(Required)**. For alpha tags this is always ALPHANUMERIC\n - ```usage_type:``` **(Required)**. For alpha tags this is always ALPHANUMERIC\n - ```label:``` **(Optional)**. A reference name for the sender ID to allow you to easily track it.\n - ```reason:``` **(Required)**. This is a specifically formatted string made up of the following sub-items (all of which are required):\n\n - `useCase:` one of the following:\n - `SOLE_TRADER_NAME`\n - `COMPANY_NAME`\n - `PARTNERSHIP_NAME`\n - `REGISTERED_TRUST_NAME`\n - `CO_OPERATIVE_NAME`\n - `INDIGENOUS_CORPORATION_NAME`\n - `REGISTERED_ORGANISATION_NAME`\n - `PERSONAL_NAME`\n - `AUSTRALIAN_TRADEMARK`\n - `INTERNATIONAL_TRADEMARK`\n - `AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY`\n - `FOREIGN_GOVERNMENT_AGENCY_OR_ENTITY`\n - `PRODUCT_OR_SERVICE_NAME`\n - `ACRONYM_INITIALISM`\n - `CONTRACTION_OF_NAME`\n - `OTHER`\n - `description:` A description used if OTHER was selected as the use case. Limited to 200 characters.\n\n - `email:` The preferred contact email for our approval team when additional details are required.\n\n - `australianGovernmentAgencyOrEntityName:` The name of your organisation.\n\n - `abn:` Your organisation’s Australian Business Number\n\n - `statement:` A legal declaration\n - If applying for your own business: \"We are authorized to use the Sender ID with a valid use case.\"\n - If applying on behalf of a third-party entity: \"We are authorized to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\"\n\nThe reason parameter must contain all the above items. A well formatted reason looks like the following:\n - \"reason\": \"{\\n  \\\\\"useCase\\\\\":\\\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\\\",\\n  \\\\\"description\\\\\":\\\\\"bal bla\\\\\",\\n  \\\\\"email\\\\\":\\\\\"example@email.com\\\\\",\\n  \\\\\"australianGovernmentAgencyOrEntityName\\\\\":\\\\\"bla bla\\\\\",\\n  \\\\\"statement\\\\\":\\\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\\\"\\n}\\n\"\n\n### Sender ID is a Personal Number\nThe following parameters are used when registering a personal mobile phone number as a Sender ID: \n\n - ```sender_address:``` **(Required)**. The phone number that you wish register as a personal number. This number must be in E.164. If this number is already registered to an account, you will receive a conflict error message. \n\n - ```destination_countries:``` **(Required)**. The country of the number that you wish to register, in two-character ISO 3166 format. Refer to the **Types of Sender ID** section for a list of currently supported countries. \n\n - ```sender_address_type:``` **(Required)**. For personal numbers this is always INTERNATIONAL \n\n - ```usage_type:``` **(Required)**. For personal numbers this is always OWN_NUMBER \n\n - ```label:``` **(Optional)**. A reference name for the sender ID to allow you to easily track it. \n\n - ```Reason:``` **(Required)**. A string describing why you wish to register the number as a Sender ID. Limited to 200 characters.\n", "operationId": "requestSenderAddressUsingPOST", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/RequestAlphaTag" }, { "$ref": "#/components/schemas/RequestVerificationCode" } ] }, "examples": { "example1": { "summary": "Example for RequestAlphaTag", "value": { "sender_address": "EXAMPLE", "sender_address_type": "ALPHANUMERIC", "usage_type": "ALPHANUMERIC", "destination_countries": [ "AU" ], "reason": "{\n \"useCase\":\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\",\n \"description\":\"bal bla\",\n \"email\":\"xample@email.com\",\n \"australianGovernmentAgencyOrEntityName\":\"bla bla\",\n \"statement\":\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\"\n}\n", "label": "label" } }, "example2": { "summary": "Example for RequestVerificationCode", "value": { "sender_address": "+61401234567", "sender_address_type": "INTERNATIONAL", "usage_type": "OWN_NUMBER", "destination_countries": [ "AU" ], "reason": "my personal number", "label": "label" } } } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": {}, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/AlphaTagRequestItem" }, { "$ref": "#/components/schemas/VerificationCodeRequestItem" } ] }, "examples": { "example1": { "summary": "Example for AlphaTagRequest", "value": { "id": "6f79a12e-14f1-4776-adc0-5c5e48a999b7", "sender_address": "EXAMPLE", "sender_address_type": "ALPHANUMERIC", "usage_type": "ALPHANUMERIC", "destination_countries": [ "AU" ], "reason": "{\n \"useCase\":\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\",\n \"description\":\"bal bla\",\n \"email\":\"xample@email.com\",\n \"australianGovernmentAgencyOrEntityName\":\"bla bla\",\n \"statement\":\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\"\n}\n", "label": "label", "status": "OPEN", "account_id": "XYZ_ExampleAccount", "created_date": "2023-10-25T14:15:22Z", "last_modified_date": "2023-10-25T14:15:22Z" } }, "example2": { "summary": "Example for VerificationCodeRequest", "value": { "id": "6f79a12e-14f1-4776-adc0-5c5e48a999b8", "sender_address": "+61401234567", "sender_address_type": "INTERNATIONAL", "usage_type": "OWN_NUMBER", "destination_countries": [ "AU" ], "reason": "my personal number", "label": "label", "status": "PENDING", "account_id": "XYZ_ExampleAccount", "created_date": "2023-10-24T14:15:22Z", "last_modified_date": "2023-10-24T14:15:22Z" } } } } } }, "400": { "description": "Bad Request" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "409": { "description": "Conflict" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"sender_address\": \"EXAMPLE\",\n \"sender_address_type\": \"ALPHANUMERIC\",\n \"usage_type\": \"ALPHANUMERIC\",\n \"destination_countries\": [\n \"AU\"\n ],\n \"reason\": \"{\\n \\\"useCase\\\":\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\",\\n \\\"description\\\":\\\"bal bla\\\",\\n \\\"email\\\":\\\"xample@email.com\\\",\\n \\\"australianGovernmentAgencyOrEntityName\\\":\\\"bla bla\\\",\\n \\\"statement\\\":\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\"\\n}\\n\",\n \"label\": \"label\"\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v1/messaging/numbers/sender_address/requests\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"sender_address\": \"EXAMPLE\",\n \"sender_address_type\": \"ALPHANUMERIC\",\n \"usage_type\": \"ALPHANUMERIC\",\n \"destination_countries\": [\n \"AU\"\n ],\n \"reason\": \"{\\n \\\"useCase\\\":\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\",\\n \\\"description\\\":\\\"bal bla\\\",\\n \\\"email\\\":\\\"xample@email.com\\\",\\n \\\"australianGovernmentAgencyOrEntityName\\\":\\\"bla bla\\\",\\n \\\"statement\\\":\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\"\\n}\\n\",\n \"label\": \"label\"\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/messaging/numbers/sender_address/requests\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"sender_address\": \"EXAMPLE\",\n \"sender_address_type\": \"ALPHANUMERIC\",\n \"usage_type\": \"ALPHANUMERIC\",\n \"destination_countries\": [\n \"AU\"\n ],\n \"reason\": \"{\\n \\\"useCase\\\":\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\",\\n \\\"description\\\":\\\"bal bla\\\",\\n \\\"email\\\":\\\"xample@email.com\\\",\\n \\\"australianGovernmentAgencyOrEntityName\\\":\\\"bla bla\\\",\\n \\\"statement\\\":\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\"\\n}\\n\",\n \"label\": \"label\"\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/messaging/numbers/sender_address/requests\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"sender_address\": \"EXAMPLE\",\n \"sender_address_type\": \"ALPHANUMERIC\",\n \"usage_type\": \"ALPHANUMERIC\",\n \"destination_countries\": [\n \"AU\"\n ],\n \"reason\": \"{\\n \\\"useCase\\\":\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\",\\n \\\"description\\\":\\\"bal bla\\\",\\n \\\"email\\\":\\\"xample@email.com\\\",\\n \\\"australianGovernmentAgencyOrEntityName\\\":\\\"bla bla\\\",\\n \\\"statement\\\":\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\"\\n}\\n\",\n \"label\": \"label\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/requests`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'EXAMPLE',\n 'sender_address_type' => 'ALPHANUMERIC',\n 'usage_type' => 'ALPHANUMERIC',\n 'destination_countries' => [\n 'AU'\n ],\n 'reason' => '{\n \"useCase\":\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\",\n \"description\":\"bal bla\",\n \"email\":\"xample@email.com\",\n \"australianGovernmentAgencyOrEntityName\":\"bla bla\",\n \"statement\":\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\"\n}\n',\n 'label' => 'label'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messaging/numbers/sender_address/requests';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"sender_address\": \"EXAMPLE\",\n \"sender_address_type\": \"ALPHANUMERIC\",\n \"usage_type\": \"ALPHANUMERIC\",\n \"destination_countries\": [\n \"AU\"\n ],\n \"reason\": \"{\\n \\\"useCase\\\":\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\",\\n \\\"description\\\":\\\"bal bla\\\",\\n \\\"email\\\":\\\"xample@email.com\\\",\\n \\\"australianGovernmentAgencyOrEntityName\\\":\\\"bla bla\\\",\\n \\\"statement\\\":\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\"\\n}\\n\",\n \"label\": \"label\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messaging/numbers/sender_address/requests'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"sender_address\" => \"EXAMPLE\",\n \"sender_address_type\" => \"ALPHANUMERIC\",\n \"usage_type\" => \"ALPHANUMERIC\",\n \"destination_countries\" => [\n \"AU\"\n ],\n \"reason\" => \"{\\n \\\"useCase\\\":\\\"AUSTRALIAN_GOVERNMENT_AGENCY_OR_ENTITY\\\",\\n \\\"description\\\":\\\"bal bla\\\",\\n \\\"email\\\":\\\"xample@email.com\\\",\\n \\\"australianGovernmentAgencyOrEntityName\\\":\\\"bla bla\\\",\\n \\\"statement\\\":\\\"We are authorised to use the Sender ID on behalf of [full entity name of sender] with a valid use case.\\\"\\n}\\n\",\n \"label\" => \"label\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messaging/numbers/sender_address/requests\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/messaging/numbers/sender_address/requests/{id}/verify": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Source Address" ], "summary": "Submitting a verification code", "description": "Complete the 2FA verification process required to register a Personal Number as a Sender ID.\nThe following parameters are required for this request:\n - ```id:``` The UUID received in the API response of your request to the **Request a Sender Address** endpoint.\n - ```verification_code:``` The six-digit code received via SMS to the phone number that you are attempting to register\n", "operationId": "SubmittingVerificationCodePost", "parameters": [ { "name": "id", "in": "path", "description": "36 character UUID.", "required": true, "style": "simple", "schema": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" } } ], "requestBody": { "description": "Verification code to be verified", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostVerificationCode" } } }, "required": true }, "responses": { "201": { "description": "Created", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerificationCodeRequestItem" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/404response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nID=\"YOUR_ID\"\n\nBODY=$(cat <<'EOF'\n{\n \"verification_code\": \"123456\"\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v1/messaging/numbers/sender_address/requests/${ID}/verify\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var id = \"YOUR_ID\";\n\n var body = \"\"\"\n {\n \"verification_code\": \"123456\"\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/messaging/numbers/sender_address/requests/{id}/verify\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String id = \"YOUR_ID\";\n\n String body = \"\"\"\n {\n \"verification_code\": \"123456\"\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/messaging/numbers/sender_address/requests/\" + id + \"/verify\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\n\nconst body = {\n \"verification_code\": \"123456\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/requests/${id}/verify`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " '123456'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messaging/numbers/sender_address/requests/' . $id . '/verify';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nid = \"YOUR_ID\"\n\nbody = {\n \"verification_code\": \"123456\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messaging/numbers/sender_address/requests/{id}/verify'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nid = \"YOUR_ID\"\n\nbody = {\n \"verification_code\" => \"123456\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messaging/numbers/sender_address/requests/#{id}/verify\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/messaging/numbers/sender_address/addresses/{id}/reverify": { "post": { "tags": [ "Source Address" ], "summary": "Re-verify Sender Address", "description": "The below table defines the allowed combination of `sender_address_type` and `usage_type` values\n\n| Description | sender_address_type | usage_type |\n| ---------------- | ------------------- | ------------ |\n| Own Number | INTERNATIONAL | OWN_NUMBER |\n\nOWN_NUMBER Sender Addresses require reverification every 12 months to allow continued use.\nThe reverification process is quite similar to the original verification process for the Sender Address, and requires a fresh 2FA check.\n\nTo reverify an OWN_NUMBER Sender Address:\n 1. Retrieve the UUID for the OWN_NUMBER using the **Get all approved sender addresses** endpoint\n 2. Make a request to this endpoint to trigger the 2FA check\n 3. Make a POST request to the **Submit verification code endpoint**, providing the new 2FA code in the body of the request\n", "operationId": "reVerifySenderAddressUsingPOST", "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "parameters": [ { "name": "id", "in": "path", "description": "Sender Address ID", "required": true, "style": "simple", "schema": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" } } ], "responses": { "200": { "description": "OK", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReVerifySenderAddressRequestItem" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/400response" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/404response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nID=\"YOUR_ID\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v1/messaging/numbers/sender_address/addresses/${ID}/reverify\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var id = \"YOUR_ID\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/messaging/numbers/sender_address/addresses/{id}/reverify\";\n using var response = await client.SendAsync(new HttpRequestMessage(new HttpMethod(\"POST\"), url));\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String id = \"YOUR_ID\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/messaging/numbers/sender_address/addresses/\" + id + \"/reverify\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/addresses/${id}/reverify`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/requests/${id}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst senderAddress = 'EXAMPLE';\nconst senderAddressType = 'ALPHANUMERIC';\nconst usageType = 'ALPHANUMERIC';\nconst includeRelatedAccounts = true;\nconst expiryStatus = 'EXPIRED';\nconst pageSize = 0;\nconst token = 'YOUR_TOKEN';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/addresses?sender_address=${senderAddress}&sender_address_type=${senderAddressType}&usage_type=${usageType}&include_related_accounts=${includeRelatedAccounts}&expiry_status=${expiryStatus}&page_size=${pageSize}&token=${token}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/addresses/${id}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\nconst reason = 'YOUR_REASON';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/addresses/${id}?reason=${reason}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\n\nconst body = {\n \"label\": \"ExampleLabel\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/sender_address/addresses/${id}`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'ExampleLabel'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messaging/numbers/sender_address/addresses/' . $id;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nid = \"YOUR_ID\"\n\nbody = {\n \"label\": \"ExampleLabel\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messaging/numbers/sender_address/addresses/{id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nid = \"YOUR_ID\"\n\nbody = {\n \"label\" => \"ExampleLabel\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messaging/numbers/sender_address/addresses/#{id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/delivery_reports": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Delivery Reports" ], "summary": "Check delivery reports", "description": "Check for any delivery reports that have been received.\nDelivery reports are a notification of the change in status of a message as it is being processed.\nEach request to the check delivery reports endpoint will return any delivery reports received that\nhave not yet been confirmed using the confirm delivery reports endpoint. A response from the check\ndelivery reports endpoint will have the following structure:\n```javascript\n{\n \"delivery_reports\": [\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"delivery_report_id\": \"01e1fa0a-6e27-4945-9cdb-18644b4de043\",\n \"source_number\": \"+61491570157\",\n \"date_received\": \"2017-05-20T06:30:37.642Z\",\n \"status\": \"enroute\",\n \"delay\": 0,\n \"billing_units\": 1,\n \"submitted_date\": \"2017-05-20T06:30:37.639Z\",\n \"original_text\": \"My first message!\",\n \"message_id\": \"d781dcab-d9d8-4fb2-9e03-872f07ae94ba\",\n \"vendor_account_id\": {\n \"vendor_id\": \"SinchEU\",\n \"account_id\": \"MyAccount\"\n },\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n }\n },\n {\n \"callback_url\": \"https://my.callback.url.com\",\n \"delivery_report_id\": \"0edf9022-7ccc-43e6-acab-480e93e98c1b\",\n \"source_number\": \"+61491570158\",\n \"date_received\": \"2017-05-21T01:46:42.579Z\",\n \"status\": \"enroute\",\n \"delay\": 0,\n \"billing_units\": 1,\n \"submitted_date\": \"2017-05-21T01:46:42.574Z\",\n \"original_text\": \"My second message!\",\n \"message_id\": \"fbb3b3f5-b702-4d8b-ab44-65b2ee39a281\",\n \"vendor_account_id\": {\n \"vendor_id\": \"SinchEU\",\n \"account_id\": \"MyAccount\"\n },\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n }\n }\n ]\n}\n```\nEach delivery report will contain details about the message, including any metadata specified\nand the new status of the message (as each delivery report indicates a change in status of a\nmessage) and the timestamp at which the status changed. Every delivery report will have a \nunique delivery report ID for use with the confirm delivery reports endpoint.\n*Note: The source number and destination number properties in a delivery report are the inverse of\nthose specified in the message that the delivery report relates to. The source number of the\ndelivery report is the destination number of the original message.*\nSubsequent requests to the check delivery reports endpoint will return the same delivery reports\nand a maximum of 100 delivery reports will be returned in each request. Applications should use the\nconfirm delivery reports endpoint in the following pattern so that delivery reports that have been\nprocessed are no longer returned in subsequent check delivery reports requests. The expiry date for getting an entity is 45 days.\n1. Call check delivery reports endpoint\n2. Process each delivery report\n3. Confirm all processed delivery reports using the confirm delivery reports endpoint\n*Note: It is recommended to use the Webhooks feature to receive reply messages rather than\npolling the check delivery reports endpoint.*", "operationId": "CheckDeliveryReports", "parameters": [], "responses": { "200": { "description": "Unconfirmed reports", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Checkdeliveryreportsresponse" }, "example": { "delivery_reports": [ { "callback_url": "https://my.callback.url.com", "delivery_report_id": "01e1fa0a-6e27-4945-9cdb-18644b4de043", "source_number": "+61491570157", "date_received": "2017-05-20T06:30:37.642Z", "status": "enroute", "delay": 0, "submitted_date": "2017-05-20T06:30:37.639Z", "original_text": "My first message!", "message_id": "d781dcab-d9d8-4fb2-9e03-872f07ae94ba", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "metadata": { "key1": "value1", "key2": "value2" } }, { "callback_url": "https://my.callback.url.com", "delivery_report_id": "0edf9022-7ccc-43e6-acab-480e93e98c1b", "source_number": "+61491570158", "date_received": "2017-05-21T01:46:42.579Z", "status": "submitted", "delay": 0, "submitted_date": "2017-05-21T01:46:42.574Z", "original_text": "My second message!", "message_id": "fbb3b3f5-b702-4d8b-ab44-65b2ee39a281", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "metadata": { "key1": "value1", "key2": "value2" } } ] } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/404response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/delivery_reports\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/delivery_reports\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/delivery_reports\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/delivery_reports`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"delivery_report_ids\": [\n \"011dcead-6988-4ad6-a1c7-6b6c68ea628d\",\n \"3487b3fa-6586-4979-a233-2d1b095c7718\",\n \"ba28e94b-c83d-4759-98e7-ff9c7edb87a1\"\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/delivery_reports/confirmed`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n '011dcead-6988-4ad6-a1c7-6b6c68ea628d',\n '3487b3fa-6586-4979-a233-2d1b095c7718',\n 'ba28e94b-c83d-4759-98e7-ff9c7edb87a1'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/delivery_reports/confirmed';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"delivery_report_ids\": [\n \"011dcead-6988-4ad6-a1c7-6b6c68ea628d\",\n \"3487b3fa-6586-4979-a233-2d1b095c7718\",\n \"ba28e94b-c83d-4759-98e7-ff9c7edb87a1\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/delivery_reports/confirmed'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"delivery_report_ids\" => [\n \"011dcead-6988-4ad6-a1c7-6b6c68ea628d\",\n \"3487b3fa-6586-4979-a233-2d1b095c7718\",\n \"ba28e94b-c83d-4759-98e7-ff9c7edb87a1\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/delivery_reports/confirmed\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/replies": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Replies" ], "summary": "Check replies", "description": "Check for any replies that have been received.\nReplies are messages that have been sent from a handset in response to a message sent by an\napplication or messages that have been sent from a handset to a inbound number associated with\nan account, known as a dedicated inbound number (contact for more\ninformation on dedicated inbound numbers).\nEach request to the check replies endpoint will return any replies received that have not yet\nbeen confirmed using the confirm replies endpoint. A response from the check replies endpoint\nwill have the following structure:\n```javascript\n{\n \"replies\": [\n {\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"message_id\": \"877c19ef-fa2e-4cec-827a-e1df9b5509f7\",\n \"reply_id\": \"a175e797-2b54-468b-9850-41a3eab32f74\",\n \"date_received\": \"2016-12-07T08:43:00.850Z\",\n \"callback_url\": \"https://my.callback.url.com\",\n \"destination_number\": \"+61491570156\",\n \"source_number\": \"+61491570157\",\n \"vendor_account_id\": {\n \"vendor_id\": \"SinchEU\",\n \"account_id\": \"MyAccount\"\n },\n \"content\": \"My first reply!\"\n },\n {\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"message_id\": \"8f2f5927-2e16-4f1c-bd43-47dbe2a77ae4\",\n \"reply_id\": \"3d8d53d8-01d3-45dd-8cfa-4dfc81600f7f\",\n \"date_received\": \"2016-12-07T08:43:00.850Z\",\n \"callback_url\": \"https://my.callback.url.com\",\n \"destination_number\": \"+61491570157\",\n \"source_number\": \"+61491570158\",\n \"vendor_account_id\": {\n \"vendor_id\": \"SinchEU\",\n \"account_id\": \"MyAccount\"\n },\n \"content\": \"My second reply!\"\n }\n ]\n}\n```\nEach reply will contain details about the reply message, as well as details of the message the reply was sent\nin response to, including any metadata specified. Every reply will have a reply ID to be used with the\nconfirm replies endpoint.\n*Note: The source number and destination number properties in a reply are the inverse of those\nspecified in the message the reply is in response to. The source number of the reply message is the\nsame as the destination number of the original message, and the destination number of the reply\nmessage is the same as the source number of the original message. If a source number\nwasn't specified in the original message, then the destination number property will not be present\nin the reply message.*\nSubsequent requests to the check replies endpoint will return the same reply messages and a maximum\nof 100 replies will be returned in each request. Applications should use the confirm replies endpoint\nin the following pattern so that replies that have been processed are no longer returned in\nsubsequent check replies requests. The expiry date for getting an entity is 45 days.\n1. Call check replies endpoint\n2. Process each reply message\n3. Confirm all processed reply messages using the confirm replies endpoint\n*Note: It is recommended to use the Webhooks feature to receive reply messages rather than polling\nthe check replies endpoint.*", "operationId": "CheckReplies", "parameters": [], "responses": { "200": { "description": "Unconfirmed replies", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Checkrepliesresponse" }, "example": { "replies": [ { "metadata": { "key1": "value1", "key2": "value2" }, "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "reply_id": "a175e797-2b54-468b-9850-41a3eab32f74", "date_received": "2016-12-07T08:43:00.850Z", "callback_url": "https://my.callback.url.com", "destination_number": "+61491570156", "source_number": "+61491570157", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "content": "My first reply!" }, { "metadata": { "key1": "value1", "key2": "value2" }, "message_id": "8f2f5927-2e16-4f1c-bd43-47dbe2a77ae4", "reply_id": "3d8d53d8-01d3-45dd-8cfa-4dfc81600f7f", "date_received": "2016-12-07T08:43:00.850Z", "callback_url": "https://my.callback.url.com", "destination_number": "+61491570157", "source_number": "+61491570158", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "content": "My second reply!" } ] } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/404response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/replies\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/replies\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/replies\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/replies`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"reply_ids\": [\n \"011dcead-6988-4ad6-a1c7-6b6c68ea628d\",\n \"3487b3fa-6586-4979-a233-2d1b095c7718\",\n \"ba28e94b-c83d-4759-98e7-ff9c7edb87a1\"\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/replies/confirmed`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n '011dcead-6988-4ad6-a1c7-6b6c68ea628d',\n '3487b3fa-6586-4979-a233-2d1b095c7718',\n 'ba28e94b-c83d-4759-98e7-ff9c7edb87a1'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/replies/confirmed';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"reply_ids\": [\n \"011dcead-6988-4ad6-a1c7-6b6c68ea628d\",\n \"3487b3fa-6586-4979-a233-2d1b095c7718\",\n \"ba28e94b-c83d-4759-98e7-ff9c7edb87a1\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/replies/confirmed'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"reply_ids\" => [\n \"011dcead-6988-4ad6-a1c7-6b6c68ea628d\",\n \"3487b3fa-6586-4979-a233-2d1b095c7718\",\n \"ba28e94b-c83d-4759-98e7-ff9c7edb87a1\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/replies/confirmed\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/number_authorisation/mt/blacklist": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Number Authorisation" ], "summary": "List all blocked numbers", "description": "This endpoint returns a list of 100 numbers that are on the blacklist. There is a pagination token to retrieve the next 100 numbers\n\nIn the example response the numbers `+61491570156` and `+61491570157` are on the blacklist and therefore will never receive any messages from you.", "operationId": "ListAllBlockedNumbers", "parameters": [ { "name": "token", "in": "query", "description": "Opaque pagination token from a previous response. Omit on the first request. Pass the returned token to retrieve the next page of up to 100 numbers.\n", "required": false, "schema": { "type": "string" }, "example": "eyJwYWdlIjoyfQ" } ], "responses": { "200": { "description": "Number authorisation blacklist was returned successfully.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Getnumberauthorisationblacklistresponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nTOKEN=\"eyJwYWdlIjoyfQ\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/number_authorisation/mt/blacklist?token=${TOKEN}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var token = \"eyJwYWdlIjoyfQ\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/number_authorisation/mt/blacklist?token={token}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String token = \"eyJwYWdlIjoyfQ\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/number_authorisation/mt/blacklist\" + \"?\" + \"token=\" + token;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst token = 'eyJwYWdlIjoyfQ';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/number_authorisation/mt/blacklist?token=${token}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"numbers\": [\n \"61491570156\",\n \"61491570157\"\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/number_authorisation/mt/blacklist`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n '61491570156',\n '61491570157'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/number_authorisation/mt/blacklist';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"numbers\": [\n \"61491570156\",\n \"61491570157\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/number_authorisation/mt/blacklist'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"numbers\" => [\n \"61491570156\",\n \"61491570157\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/number_authorisation/mt/blacklist\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/number_authorisation/mt/blacklist/{number}": { "delete": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Number Authorisation" ], "summary": "Remove a number from the blacklist", "description": "This endpoint allows you to remove a number from the blacklist. Only one number can be deleted per request.\nIn the example +61491570157 will be removed from the blacklist.\nNOTE: numbers need to be in international format and therefore start with a +", "operationId": "RemoveANumberFromTheBlacklist", "parameters": [ { "in": "path", "name": "number", "required": true, "schema": { "type": "string", "example": "+61491570156" }, "description": "a number in international format e.g. ```+61491570156```", "example": "+61491570156" } ], "responses": { "200": { "description": "The number has been successfully deleted.", "headers": {}, "content": { "text/plain": { "schema": { "type": "string", "description": "The number has been successfully deleted.", "format": "binary" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "description": "Not found." } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nNUMBER=\"YOUR_NUMBER\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X DELETE \"${API_HOST}/v1/number_authorisation/mt/blacklist/${NUMBER}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var number = \"YOUR_NUMBER\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/number_authorisation/mt/blacklist/{number}\";\n using var response = await client.DeleteAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String number = \"YOUR_NUMBER\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/number_authorisation/mt/blacklist/\" + number;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"DELETE\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst number = 'YOUR_NUMBER';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/number_authorisation/mt/blacklist/${number}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst numbers = 'YOUR_NUMBERS';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/number_authorisation/is_authorised/${numbers}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst country = 'YOUR_COUNTRY';\nconst matching = 'YOUR_MATCHING';\nconst pageSize = 0;\nconst serviceTypes = 'YOUR_SERVICE_TYPES';\nconst types = 'YOUR_TYPES';\nconst token = 'YOUR_TOKEN';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated?country=${country}&matching=${matching}&page_size=${pageSize}&service_types=${serviceTypes}&types=${types}&token=${token}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst id = 'YOUR_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated/${id}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst numberId = 'YOUR_NUMBER_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated/${numberId}/assignment`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst numberId = 'YOUR_NUMBER_ID';\n\nconst body = {\n \"label\": \"ExampleLabel\",\n \"metadata\": {\n \"Key1\": \"value1\",\n \"Key2\": \"value2\"\n }\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated/${numberId}/assignment`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'ExampleLabel',\n 'metadata' => [\n 'Key1' => 'value1',\n 'Key2' => 'value2'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messaging/numbers/dedicated/' . $numberId . '/assignment';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nnumber_id = \"YOUR_NUMBER_ID\"\n\nbody = {\n \"label\": \"ExampleLabel\",\n \"metadata\": {\n \"Key1\": \"value1\",\n \"Key2\": \"value2\"\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messaging/numbers/dedicated/{number_id}/assignment'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nnumber_id = \"YOUR_NUMBER_ID\"\n\nbody = {\n \"label\" => \"ExampleLabel\",\n \"metadata\" => {\n \"Key1\" => \"value1\",\n \"Key2\" => \"value2\"\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messaging/numbers/dedicated/#{number_id}/assignment\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] }, "delete": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Dedicated Numbers" ], "summary": "Delete assignment", "description": "Release the dedicated number from your account.", "operationId": "DeleteAssignment", "parameters": [ { "name": "numberId", "in": "path", "description": "unique identifier", "required": true, "style": "simple", "schema": { "type": "string", "example": "b9ee3fe8-2c20-47b1-96e9-c5d12d7ed985" } }, { "name": "Accept", "in": "header", "description": "Requested response media type.", "required": true, "style": "simple", "schema": { "type": "string", "example": "application/json;charset=UTF-8" } } ], "responses": { "204": { "description": "No Content", "headers": {}, "content": { "application/json;charset=UTF-8": { "schema": { "type": "string", "description": "No Content", "format": "binary" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" }, "example": { "message": "Invalid authentication credentials" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nNUMBER_ID=\"YOUR_NUMBER_ID\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X DELETE \"${API_HOST}/v1/messaging/numbers/dedicated/${NUMBER_ID}/assignment\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var numberId = \"YOUR_NUMBER_ID\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/messaging/numbers/dedicated/{numberId}/assignment\";\n using var response = await client.DeleteAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String numberId = \"YOUR_NUMBER_ID\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/messaging/numbers/dedicated/\" + numberId + \"/assignment\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"DELETE\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst numberId = 'YOUR_NUMBER_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated/${numberId}/assignment`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst numberId = 'YOUR_NUMBER_ID';\n\nconst body = {\n \"label\": \"ExampleLabel\",\n \"metadata\": {\n \"Key1\": \"value1\",\n \"Key2\": \"value2\"\n }\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated/${numberId}/assignment`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'ExampleLabel',\n 'metadata' => [\n 'Key1' => 'value1',\n 'Key2' => 'value2'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/messaging/numbers/dedicated/' . $numberId . '/assignment';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nnumber_id = \"YOUR_NUMBER_ID\"\n\nbody = {\n \"label\": \"ExampleLabel\",\n \"metadata\": {\n \"Key1\": \"value1\",\n \"Key2\": \"value2\"\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/messaging/numbers/dedicated/{number_id}/assignment'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nnumber_id = \"YOUR_NUMBER_ID\"\n\nbody = {\n \"label\" => \"ExampleLabel\",\n \"metadata\" => {\n \"Key1\" => \"value1\",\n \"Key2\" => \"value2\"\n }\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/messaging/numbers/dedicated/#{number_id}/assignment\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/messaging/numbers/dedicated/assignments": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Dedicated Numbers" ], "summary": "Get assigned numbers", "description": "Retrieves the list of assigned dedicated numbers.", "operationId": "GetAssignedNumbers", "parameters": [ { "name": "page_size", "in": "query", "description": "Number of results returned per page, default 50", "style": "form", "explode": true, "schema": { "type": "integer", "format": "int32", "example": 20 } }, { "name": "token", "in": "query", "description": "In paginated data the original request will return with a \"next_token\" attribute. This token must be entered into subsequent call in the \"token\" query parameter to obtain the next set of records.", "style": "form", "explode": true, "schema": { "type": "string", "example": "eyJwYWdlIjoyfQ" } }, { "name": "number_id", "in": "query", "description": "Unique identifier of a specific number", "style": "form", "explode": true, "schema": { "type": "string", "example": "examples" } }, { "name": "matching", "in": "query", "description": "Filters results by a pattern of digits contained within the number", "style": "form", "explode": true, "schema": { "type": "string", "example": "223344" } }, { "name": "country", "in": "query", "description": "Filter results by ISO_3166 country code, 2 character code to filter available numbers by country", "style": "form", "explode": true, "schema": { "type": "string", "example": "AU" } }, { "name": "type", "in": "query", "description": "Filter results by Number type. When both `type` and `types` are provided, `types` will take precedence, and `type` will be ignored.", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/Type" } }, { "name": "types", "in": "query", "description": "Filter results by Number Types", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/Types" } }, { "name": "classification", "in": "query", "description": "Filter results by Number Classification", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/Classification" } }, { "name": "service_types", "in": "query", "description": "Filter results by capabilities", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/service_types" } }, { "name": "label", "in": "query", "description": "Filter results by a matching label", "style": "form", "explode": true, "schema": { "type": "string", "example": "examples" } }, { "name": "sort_by", "in": "query", "description": "Sort results by property", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/sort_by" }, "example": "TIMESTAMP" }, { "name": "sort_direction", "in": "query", "description": "Sort direction", "style": "form", "explode": true, "schema": { "$ref": "#/components/schemas/sort_direction" }, "example": "ASCENDING" }, { "name": "Accept", "in": "header", "description": "Requested response media type.", "required": true, "style": "simple", "schema": { "type": "string", "example": "application/json;charset=UTF-8" } } ], "responses": { "200": { "description": "OK", "headers": {}, "content": { "application/json;charset=UTF-8": { "schema": { "$ref": "#/components/schemas/AssignedNumberListResponse" }, "example": { "pagination": { "next_token": "0428d673-0f75-4063-9493-e89d75f13438", "page_size": 5 }, "data": [ { "assignment": { "metadata": { "Key1": "value1", "Key2": "value2" }, "label": "LabelTest0", "id": "be3cb602-7c00-4c87-ae4b-b8defc04f179", "number_id": "b9ee3fe8-2c20-47b1-96e9-c5d12d7ed985" }, "number": { "id": "03cf54ad-a4a3-4cd1-afd5-e0ca2cf158a3", "phone_number": "61436489205", "country": "AU", "type": "MOBILE", "classification": "BRONZE", "available_after": "2019-08-06T23:56:15.633Z", "capabilities": [ "SMS" ] } } ] } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/403response" }, "example": { "message": "Invalid authentication credentials" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nPAGE_SIZE=\"0\"\nTOKEN=\"YOUR_TOKEN\"\nNUMBER_ID=\"YOUR_NUMBER_ID\"\nMATCHING=\"YOUR_MATCHING\"\nCOUNTRY=\"YOUR_COUNTRY\"\nTYPE=\"YOUR_TYPE\"\nTYPES=\"YOUR_TYPES\"\nCLASSIFICATION=\"YOUR_CLASSIFICATION\"\nSERVICE_TYPES=\"YOUR_SERVICE_TYPES\"\nLABEL=\"YOUR_LABEL\"\nSORT_BY=\"TIMESTAMP\"\nSORT_DIRECTION=\"ASCENDING\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/messaging/numbers/dedicated/assignments?page_size=${PAGE_SIZE}&token=${TOKEN}&number_id=${NUMBER_ID}&matching=${MATCHING}&country=${COUNTRY}&type=${TYPE}&types=${TYPES}&classification=${CLASSIFICATION}&service_types=${SERVICE_TYPES}&label=${LABEL}&sort_by=${SORT_BY}&sort_direction=${SORT_DIRECTION}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var pageSize = 0;\n var token = \"YOUR_TOKEN\";\n var numberId = \"YOUR_NUMBER_ID\";\n var matching = \"YOUR_MATCHING\";\n var country = \"YOUR_COUNTRY\";\n var type = \"YOUR_TYPE\";\n var types = \"YOUR_TYPES\";\n var classification = \"YOUR_CLASSIFICATION\";\n var serviceTypes = \"YOUR_SERVICE_TYPES\";\n var label = \"YOUR_LABEL\";\n var sortBy = \"TIMESTAMP\";\n var sortDirection = \"ASCENDING\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/messaging/numbers/dedicated/assignments?page_size={pageSize}&token={token}&number_id={numberId}&matching={matching}&country={country}&type={type}&types={types}&classification={classification}&service_types={serviceTypes}&label={label}&sort_by={sortBy}&sort_direction={sortDirection}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n int pageSize = 0;\n String token = \"YOUR_TOKEN\";\n String numberId = \"YOUR_NUMBER_ID\";\n String matching = \"YOUR_MATCHING\";\n String country = \"YOUR_COUNTRY\";\n String type = \"YOUR_TYPE\";\n String types = \"YOUR_TYPES\";\n String classification = \"YOUR_CLASSIFICATION\";\n String serviceTypes = \"YOUR_SERVICE_TYPES\";\n String label = \"YOUR_LABEL\";\n String sortBy = \"TIMESTAMP\";\n String sortDirection = \"ASCENDING\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/messaging/numbers/dedicated/assignments\" + \"?\" + \"page_size=\" + pageSize + \"&\" + \"token=\" + token + \"&\" + \"number_id=\" + numberId + \"&\" + \"matching=\" + matching + \"&\" + \"country=\" + country + \"&\" + \"type=\" + type + \"&\" + \"types=\" + types + \"&\" + \"classification=\" + classification + \"&\" + \"service_types=\" + serviceTypes + \"&\" + \"label=\" + label + \"&\" + \"sort_by=\" + sortBy + \"&\" + \"sort_direction=\" + sortDirection;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst pageSize = 0;\nconst token = 'YOUR_TOKEN';\nconst numberId = 'YOUR_NUMBER_ID';\nconst matching = 'YOUR_MATCHING';\nconst country = 'YOUR_COUNTRY';\nconst type = 'YOUR_TYPE';\nconst types = 'YOUR_TYPES';\nconst classification = 'YOUR_CLASSIFICATION';\nconst serviceTypes = 'YOUR_SERVICE_TYPES';\nconst label = 'YOUR_LABEL';\nconst sortBy = 'TIMESTAMP';\nconst sortDirection = 'ASCENDING';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/messaging/numbers/dedicated/assignments?page_size=${pageSize}&token=${token}&number_id=${numberId}&matching=${matching}&country=${country}&type=${type}&types=${types}&classification=${classification}&service_types=${serviceTypes}&label=${label}&sort_by=${sortBy}&sort_direction=${sortDirection}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst key = 'YOUR_KEY';\nconst value = 'YOUR_VALUE';\nconst url = 'YOUR_URL';\nconst recipient = 'YOUR_RECIPIENT';\nconst page = 0;\nconst pageSize = 0;\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/reporting/links/summary?key=${key}&value=${value}&url=${url}&recipient=${recipient}&page=${page}&pageSize=${pageSize}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst hash = 'YOUR_HASH';\nconst page = 0;\nconst pageSize = 0;\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/reporting/links/detail?hash=${hash}&page=${page}&pageSize=${pageSize}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst page = 0;\nconst pageSize = 20;\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/webhooks/messages?page=${page}&page_size=${pageSize}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": "[
{
\"content_type\": \"image/png\",
\"content\": \"...\",
\"original_name\": \"file.png\"
}
] | `MO MMS` |\n\n#### Example Webhook Request with Templates\n\n##### MO / MO MMS\n\n```\n{\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"events\": [\"RECEIVED_MMS\"],\n \"template\": \"{ \\\"account_id\\\": \\\"$accountId\\\", \\\"reply_id\\\": \\\"$replyId\\\", \\\"destination_number\\\": \\\"$destinationAddress\\\", \\\"source_number\\\": \\\"$sourceAddress\\\", \\\"date_received\\\": \\\"$receivedTimestamp\\\", \\\"message_id\\\": \\\"$messageId\\\", #if ($attachments) \\\"attachments\\\": [ #foreach ($entry in $attachments) { \\\"content_type\\\": \\\"$entry.contentType\\\", \\\"content\\\": \\\"$entry.base64\\\", \\\"original_name\\\": \\\"$entry.originalName\\\" }#if( $foreach.hasNext ),#end #end ], #else \\\"content\\\": \\\"$esc.json($moContent)\\\", #end \\\"metadata\\\": { #foreach ($entry in $metadata.entrySet()) \\\"$entry.key\\\": \\\"$entry.value\\\"#if( $foreach.hasNext ),#end #end }}\"\n}\n```\n\n##### DR (Delivery Report)\n\n```\n{\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"events\": [\"DELIVERED_DR\"],\n \"template\": \"{ \\\"delivery_report_id\\\": \\\"$drId\\\", \\\"source_number\\\": \\\"$sourceAddress\\\", \\\"date_received\\\": \\\"$receivedTimestamp\\\", \\\"status\\\": \\\"$status\\\", \\\"delay\\\": \\\"0\\\", \\\"submitted_date\\\": \\\"$submittedTimestamp\\\", \\\"message_id\\\": \\\"$messageId\\\", \\\"original_text\\\": \\\"$esc.json($!mtContent)\\\", \\\"vendor_account_id\\\": { \\\"vendor_id\\\": \\\"$vendorId\\\", \\\"account_id\\\": \\\"$accountId\\\" }, \\\"error_code\\\": \\\"$statusCode\\\", \\\"metadata\\\": { #foreach($key in $metadata.keySet()) \\\"$key\\\": \\\"$esc.json($metadata.get($key))\\\"#if( $velocityHasNext ),#end #end }}\"\n}\n```\n\n #### Message Statuses\n\nDelivery Reports indicate message status. A message can have one of the following statuses:\n* `enroute`: Message has been received by the gateway and is being processed (or waiting to be processed).\n* `submitted`: Message has been submitted to a provider/carrier for delivery.\n* `delivered`: Message delivery has been confirmed by the provider, including to the handset (where possible).\n* `expired`: The message has expired.\n* `rejected`: The message will not be delivered - permanent failure. Reasons may include usage limit exceeded, insufficient credit, number blocked, or content filtered\n* `failed`: The message has failed. Reasons may include no active routes to destination or undeliverable by downstream provider.\n\n#### Message Status Codes\nStatus codes provide more granular insight into a message's status. A message can have one of the following status codes:\n* `101`: Message being processed by the gateway.\n* `102`: Message is being rerouted to a different provider after failing via the first provider.\n* `151`: Message held for screening.\n* `200`: Message submitted to downstream provider for delivery.\n* `210`: Message accepted by downstream provider.\n* `211`: Message is enroute for delivery by provider.\n* `212`: Message submitted. Delivery pending.\n* `213`: Message scheduled for delivery by downstream provider.\n* `220`: Message delivered.\n* `221`: Message delivered to the handset.\n* `320`: Message validity period has expired (prior to submission).\n* `401`: Message validity period has expired (before delivery).\n* `301`: Usage threshold reached. Message discarded.\n* `302`: Destination address blocked. Message discarded.\n* `303`: Source address blocked. Message discarded.\n* `304`: Message dropped. Contact support.\n* `305`: Message discarded due to duplicate detection.\n* `402`: Message rejected by downstream provider.\n* `403`: Message skipped by downstream provider.\n* `410`: Invalid source address.\n* `411`: Invalid destination address.\n* `412`: Destination address blocked.\n* `413`: SMS service unavailable on destination.\n* `414`: Destination unreachable.\n* `330`: Gateway failure.\n* `331`: Message discarded.\n* `332`: No available route to destination.\n* `333`: Source address unsupported for this destination.\n* `400`: Message failed; undeliverable.\n* `405`: Message cancelled or deleted by provider.\n\n*Note: A 400 response will be returned if the request body cannot be parsed, the `url` is invalid (for example, malformed hostname or DNS syntax, unsupported scheme such as `ftp`, or path containing whitespace or control characters — e.g. `https://-invalid.com`, `https://invalid_.com`, `https:///path`, `https://:/path`, `http://.example.com`, `http://example..com`), an `events` value is not recognised (e.g. `RECEIVED_123`), the `events`, `encoding` or `method` is null, or the `headers` has a Content-Type attribute.*\n", "operationId": "CreateWebhook", "parameters": [], "requestBody": { "description": "Request body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookrequest" }, "example": { "url": "http://webhook.com", "method": "POST", "encoding": "JSON", "headers": {}, "events": [ "ENROUTE_DR", "DELIVERED_DR" ], "template": "{\"id\":\"$mtId\",\"status\":\"$statusCode\"}", "read_timeout": 5000, "retries": 3, "retry_delay": 30 } } }, "required": true }, "responses": { "201": { "description": "Webhook successfully created", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWebhookresponse" }, "example": { "id": "76fa7010-8c1f-4a24-917a-4d62a54e744d", "url": "http://webhook.com", "method": "POST", "encoding": "JSON", "headers": {}, "events": [ "ENROUTE_DR", "DELIVERED_DR" ], "template": "{\"id\":\"$mtId\",\"status\":\"$statusCode\"}", "read_timeout": 5000, "retries": 3, "retry_delay": 30 } } } }, "400": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhook400response" }, "examples": { "invalidUrl": { "summary": "Invalid URL", "value": { "message": "Bad Request", "details": [ "/url: Not a valid http url" ] } }, "invalidEvents": { "summary": "Unrecognised event type", "value": { "message": "Bad Request", "details": [ "/events/0: [RECEIVED_123] is invalid" ] } }, "unparseableBody": { "summary": "Unparseable request body", "value": { "message": "Bad Request", "details": [ "Failed to parse message body." ] } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "409": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhook400response" }, "example": { "message": "A webhook with the given url and method already exists." } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\",\n \"read_timeout\": 5000,\n \"retries\": 3,\n \"retry_delay\": 30\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/v1/webhooks/messages\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\",\n \"read_timeout\": 5000,\n \"retries\": 3,\n \"retry_delay\": 30\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/webhooks/messages\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\",\n \"read_timeout\": 5000,\n \"retries\": 3,\n \"retry_delay\": 30\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/webhooks/messages\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\",\n \"read_timeout\": 5000,\n \"retries\": 3,\n \"retry_delay\": 30\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/webhooks/messages`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'http://webhook.com',\n 'method' => 'POST',\n 'encoding' => 'JSON',\n 'headers' => [],\n 'events' => [\n 'ENROUTE_DR',\n 'DELIVERED_DR'\n ],\n 'template' => '{\"id\":\"$mtId\",\"status\":\"$statusCode\"}',\n 'read_timeout' => 5000,\n 'retries' => 3,\n 'retry_delay' => 30\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/webhooks/messages';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\",\n \"read_timeout\": 5000,\n \"retries\": 3,\n \"retry_delay\": 30\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/webhooks/messages'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"url\" => \"http://webhook.com\",\n \"method\" => \"POST\",\n \"encoding\" => \"JSON\",\n \"headers\" => {},\n \"events\" => [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\" => \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\",\n \"read_timeout\" => 5000,\n \"retries\" => 3,\n \"retry_delay\" => 30\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/webhooks/messages\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/webhooks/messages/{webhookId}": { "delete": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Webhooks Management" ], "summary": "Delete webhook", "description": "Delete a webhook that was previously created for the connected account.\nA webhook can be cancelled by appending the UUID of the webhook to the endpoint and submitting a DELETE request to the /webhooks/messages endpoint.\n\nA successful request to the retrieve webhook endpoint will return a null response.\n\n*Note: Only pre-created webhooks can be deleted. If an invalid or non existent webhook ID parameter is specified in the request, then a HTTP 404 Not Found response will be returned.*", "operationId": "DeleteWebhook", "parameters": [ { "name": "webhookId", "in": "path", "description": "Unique identifier of the webhook.", "required": true, "style": "simple", "schema": { "type": "string", "format": "uuid", "example": "a7f11bb0-f299-4861-a5ca-9b29d04bc5ad" }, "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" } ], "responses": { "204": { "description": "Webhook deleted successfully", "headers": {} }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "description": "Not found." } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nWEBHOOK_ID=\"YOUR_WEBHOOK_ID\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X DELETE \"${API_HOST}/v1/webhooks/messages/${WEBHOOK_ID}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var webhookId = \"YOUR_WEBHOOK_ID\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/webhooks/messages/{webhookId}\";\n using var response = await client.DeleteAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String webhookId = \"YOUR_WEBHOOK_ID\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/webhooks/messages/\" + webhookId;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"DELETE\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst webhookId = 'YOUR_WEBHOOK_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/webhooks/messages/${webhookId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst webhookId = 'YOUR_WEBHOOK_ID';\n\nconst body = {\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/webhooks/messages/${webhookId}`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'http://webhook.com',\n 'method' => 'POST',\n 'encoding' => 'JSON',\n 'headers' => [],\n 'events' => [\n 'ENROUTE_DR',\n 'DELIVERED_DR'\n ],\n 'template' => '{\"id\":\"$mtId\",\"status\":\"$statusCode\"}'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/webhooks/messages/' . $webhookId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nwebhook_id = \"YOUR_WEBHOOK_ID\"\n\nbody = {\n \"url\": \"http://webhook.com\",\n \"method\": \"POST\",\n \"encoding\": \"JSON\",\n \"headers\": {},\n \"events\": [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\": \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/webhooks/messages/{webhook_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nwebhook_id = \"YOUR_WEBHOOK_ID\"\n\nbody = {\n \"url\" => \"http://webhook.com\",\n \"method\" => \"POST\",\n \"encoding\" => \"JSON\",\n \"headers\" => {},\n \"events\" => [\n \"ENROUTE_DR\",\n \"DELIVERED_DR\"\n ],\n \"template\" => \"{\\\"id\\\":\\\"$mtId\\\",\\\"status\\\":\\\"$statusCode\\\"}\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/webhooks/messages/#{webhook_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/iam/signature_keys": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Signature Key Management" ], "summary": "Get signature key list", "description": "Retrieve the paginated list of signature keys.\n\nA successful request for the ```get signature key list``` endpoint will return a response body as follows:\n\n```javascript\n[\n {\n \"key_id\": \"7ca628a8-08b0-4e42-aeb8-960b37049c31\",\n \"cipher\": \"RSA\",\n \"digest\": \"SHA224\",\n \"created\": \"2018-01-18T10:16:12.364Z\",\n \"enabled\": false\n }\n]\n```", "operationId": "GetSignatureKeyList", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination (1-based).", "required": true, "schema": { "type": "string", "example": "1" } }, { "name": "page_size", "in": "query", "description": "Number of results per page.", "required": true, "schema": { "type": "string", "example": "20" } } ], "responses": { "200": { "description": "The list of signature keys.", "headers": {}, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Getsignaturekeylistresponse" }, "description": "The list of signature keys." }, "example": [ { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": true }, { "key_id": "6a0108cf-3659-435e-800e-004beb910fd1", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:15:31.035Z", "enabled": false } ] } } }, "400": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Enablesignaturekey400response" }, "example": { "message": "Bad Request", "details": [ "page property value is invalid" ] } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Disablethecurrentenabledsignaturekey.403response" }, "example": { "message": "This feature has not been enabled in your account." } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nPAGE=\"YOUR_PAGE\"\nPAGE_SIZE=\"YOUR_PAGE_SIZE\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/iam/signature_keys?page=${PAGE}&page_size=${PAGE_SIZE}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var page = \"YOUR_PAGE\";\n var pageSize = \"YOUR_PAGE_SIZE\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/iam/signature_keys?page={page}&page_size={pageSize}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String page = \"YOUR_PAGE\";\n String pageSize = \"YOUR_PAGE_SIZE\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/iam/signature_keys\" + \"?\" + \"page=\" + page + \"&\" + \"page_size=\" + pageSize;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst page = 'YOUR_PAGE';\nconst pageSize = 'YOUR_PAGE_SIZE';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys?page=${page}&page_size=${pageSize}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"digest\": \"SHA224\",\n \"cipher\": \"RSA\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'SHA224',\n 'cipher' => 'RSA'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/iam/signature_keys';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"digest\": \"SHA224\",\n \"cipher\": \"RSA\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/iam/signature_keys'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"digest\" => \"SHA224\",\n \"cipher\" => \"RSA\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/iam/signature_keys\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/v1/iam/signature_keys/{key_id}": { "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Signature Key Management" ], "summary": "Get signature key detail", "description": "Retrieve the current detail of a signature key using the key_id returned in the ```create signature key``` endpoint.\n\nA successful request for the ```get signature key detail``` endpoint will return a response body as follows:\n\n```javascript\n{\n \"key_id\": \"7ca628a8-08b0-4e42-aeb8-960b37049c31\",\n \"cipher\": \"RSA\",\n \"digest\": \"SHA224\",\n \"created\": \"2018-01-18T10:16:12.364Z\",\n \"enabled\": false\n}\n```\n\n*Note: If an invalid or non-existent key_id parameter is specified in the request, then an HTTP 404 Not Found response will be returned*", "operationId": "GetSignatureKeyDetail", "parameters": [ { "name": "key_id", "in": "path", "description": "Unique identifier of the signature key.", "required": true, "style": "simple", "schema": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" } } ], "responses": { "200": { "description": "The detail of signature key.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Getsignaturekeydetailresponse" }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": false } } } }, "400": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Enablesignaturekey400response" }, "example": { "message": "Bad Request", "details": [ "key_id property value is invalid" ] } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Disablethecurrentenabledsignaturekey.403response" }, "example": { "message": "This feature has not been enabled in your account." } } } }, "404": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Disablethecurrentenabledsignaturekey.403response" }, "example": { "message": "Entity not found" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nKEY_ID=\"YOUR_KEY_ID\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/iam/signature_keys/${KEY_ID}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var keyId = \"YOUR_KEY_ID\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/iam/signature_keys/{keyId}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String keyId = \"YOUR_KEY_ID\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/iam/signature_keys/\" + keyId;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst keyId = 'YOUR_KEY_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys/${keyId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst keyId = 'YOUR_KEY_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys/${keyId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"key_id\": \"7ca628a8-08b0-4e42-aeb8-960b37049c31\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys/enabled`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " '7ca628a8-08b0-4e42-aeb8-960b37049c31'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/v1/iam/signature_keys/enabled';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"key_id\": \"7ca628a8-08b0-4e42-aeb8-960b37049c31\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/v1/iam/signature_keys/enabled'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"key_id\" => \"7ca628a8-08b0-4e42-aeb8-960b37049c31\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/v1/iam/signature_keys/enabled\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] }, "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Signature Key Management" ], "summary": "Get enabled signature key", "description": "Retrieve the currently enabled signature key.\n\nA successful request for the ```get enabled signature key``` endpoint will return a response body as follows:\n\n```javascript\n{\n \"key_id\": \"7ca628a8-08b0-4e42-aeb8-960b37049c31\",\n \"cipher\": \"RSA\",\n \"digest\": \"SHA224\",\n \"created\": \"2018-01-18T10:16:12.364Z\",\n \"enabled\": true\n}\n```\n\n*Note: If there is no enabled signature key, then an HTTP 404 Not Found response will be returned*", "operationId": "GetEnabledSignatureKey", "responses": { "200": { "description": "The detail of signature key.", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Getenabledsignaturekeyresponse" }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": true } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Disablethecurrentenabledsignaturekey.403response" }, "example": { "message": "This feature has not been enabled in your account." } } } }, "404": { "description": "Unexpected error in API call. See HTTP response body for details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Disablethecurrentenabledsignaturekey.403response" }, "example": { "message": "Currently no key is enabled" } } } } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/v1/iam/signature_keys/enabled\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/v1/iam/signature_keys/enabled\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/v1/iam/signature_keys/enabled\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys/enabled`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/v1/iam/signature_keys/enabled`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"firstName\": \"Adam\",\n \"lastName\": \"Smith\",\n \"alias\": \"user1234\",\n \"dateOfBirth\": \"2022-08-18\",\n \"country\": \"US\",\n \"state\": \"CA\",\n \"location\": \"Sunset Blvd\",\n \"note\": \"Note\",\n \"channels\": [\n {\n \"channelId\": \"+15553456783\",\n \"type\": \"SMS\",\n \"subscriptionState\": \"UNSUBSCRIBED\"\n }\n ],\n \"lists\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n }\n ],\n \"customFields\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\",\n \"value\": \"John\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/contacts`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Adam',\n 'lastName' => 'Smith',\n 'alias' => 'user1234',\n 'dateOfBirth' => '2022-08-18',\n 'country' => 'US',\n 'state' => 'CA',\n 'location' => 'Sunset Blvd',\n 'note' => 'Note',\n 'channels' => [\n [\n 'channelId' => '+15553456783',\n 'type' => 'SMS',\n 'subscriptionState' => 'UNSUBSCRIBED'\n ]\n ],\n 'lists' => [\n [\n 'id' => '025e93d3-051b-43f9-b12e-4b5842228dee'\n ]\n ],\n 'customFields' => [\n [\n 'id' => '025e93d3-051b-43f9-b12e-4b5842228dee',\n 'value' => 'John'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/contacts';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"firstName\": \"Adam\",\n \"lastName\": \"Smith\",\n \"alias\": \"user1234\",\n \"dateOfBirth\": \"2022-08-18\",\n \"country\": \"US\",\n \"state\": \"CA\",\n \"location\": \"Sunset Blvd\",\n \"note\": \"Note\",\n \"channels\": [\n {\n \"channelId\": \"+15553456783\",\n \"type\": \"SMS\",\n \"subscriptionState\": \"UNSUBSCRIBED\"\n }\n ],\n \"lists\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n }\n ],\n \"customFields\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\",\n \"value\": \"John\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/contacts'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"firstName\" => \"Adam\",\n \"lastName\" => \"Smith\",\n \"alias\" => \"user1234\",\n \"dateOfBirth\" => \"2022-08-18\",\n \"country\" => \"US\",\n \"state\" => \"CA\",\n \"location\" => \"Sunset Blvd\",\n \"note\" => \"Note\",\n \"channels\" => [\n {\n \"channelId\" => \"+15553456783\",\n \"type\" => \"SMS\",\n \"subscriptionState\" => \"UNSUBSCRIBED\"\n }\n ],\n \"lists\" => [\n {\n \"id\" => \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n }\n ],\n \"customFields\" => [\n {\n \"id\" => \"025e93d3-051b-43f9-b12e-4b5842228dee\",\n \"value\" => \"John\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/contacts\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] }, "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Contacts" ], "summary": "Get contacts page", "description": "Retrieves a paginated list of contacts.", "operationId": "getContactsPage", "parameters": [ { "name": "request", "in": "query", "required": true, "description": "Pagination and filter options for the contacts page (page tokens, page size, list/contact/channel filters).\n", "schema": { "$ref": "#/components/schemas/GetContactsRequest" } } ], "responses": { "200": { "description": "Returns a contacts page", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/PageTokenDtoContactData" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "501": { "$ref": "#/components/responses/RequestNotRecognised" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServerUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nREQUEST=\"YOUR_REQUEST\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/api/v1/contacts/contacts?request=${REQUEST}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var request = \"YOUR_REQUEST\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/api/v1/contacts/contacts?request={request}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String request = \"YOUR_REQUEST\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/api/v1/contacts/contacts\" + \"?\" + \"request=\" + request;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst request = 'YOUR_REQUEST';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/contacts?request=${request}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst contactId = 'YOUR_CONTACT_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/contacts/${contactId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst contactId = 'YOUR_CONTACT_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/contacts/${contactId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst contactId = 'YOUR_CONTACT_ID';\n\nconst body = {\n \"firstName\": \"Adam\",\n \"lastName\": \"Smith\",\n \"alias\": \"user1234\",\n \"dateOfBirth\": \"2022-08-18\",\n \"country\": \"US\",\n \"state\": \"CA\",\n \"location\": \"Sunset Blvd\",\n \"note\": \"Note\",\n \"channels\": [\n {\n \"channelId\": \"+15553456783\",\n \"type\": \"SMS\",\n \"subscriptionState\": \"UNSUBSCRIBED\"\n }\n ],\n \"lists\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n }\n ],\n \"customFields\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\",\n \"value\": \"John\"\n }\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/contacts/${contactId}`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Adam',\n 'lastName' => 'Smith',\n 'alias' => 'user1234',\n 'dateOfBirth' => '2022-08-18',\n 'country' => 'US',\n 'state' => 'CA',\n 'location' => 'Sunset Blvd',\n 'note' => 'Note',\n 'channels' => [\n [\n 'channelId' => '+15553456783',\n 'type' => 'SMS',\n 'subscriptionState' => 'UNSUBSCRIBED'\n ]\n ],\n 'lists' => [\n [\n 'id' => '025e93d3-051b-43f9-b12e-4b5842228dee'\n ]\n ],\n 'customFields' => [\n [\n 'id' => '025e93d3-051b-43f9-b12e-4b5842228dee',\n 'value' => 'John'\n ]\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/contacts/' . $contactId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\ncontact_id = \"YOUR_CONTACT_ID\"\n\nbody = {\n \"firstName\": \"Adam\",\n \"lastName\": \"Smith\",\n \"alias\": \"user1234\",\n \"dateOfBirth\": \"2022-08-18\",\n \"country\": \"US\",\n \"state\": \"CA\",\n \"location\": \"Sunset Blvd\",\n \"note\": \"Note\",\n \"channels\": [\n {\n \"channelId\": \"+15553456783\",\n \"type\": \"SMS\",\n \"subscriptionState\": \"UNSUBSCRIBED\"\n }\n ],\n \"lists\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n }\n ],\n \"customFields\": [\n {\n \"id\": \"025e93d3-051b-43f9-b12e-4b5842228dee\",\n \"value\": \"John\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/contacts/{contact_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\ncontact_id = \"YOUR_CONTACT_ID\"\n\nbody = {\n \"firstName\" => \"Adam\",\n \"lastName\" => \"Smith\",\n \"alias\" => \"user1234\",\n \"dateOfBirth\" => \"2022-08-18\",\n \"country\" => \"US\",\n \"state\" => \"CA\",\n \"location\" => \"Sunset Blvd\",\n \"note\" => \"Note\",\n \"channels\" => [\n {\n \"channelId\" => \"+15553456783\",\n \"type\" => \"SMS\",\n \"subscriptionState\" => \"UNSUBSCRIBED\"\n }\n ],\n \"lists\" => [\n {\n \"id\" => \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n }\n ],\n \"customFields\" => [\n {\n \"id\" => \"025e93d3-051b-43f9-b12e-4b5842228dee\",\n \"value\" => \"John\"\n }\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/contacts/#{contact_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/api/v1/contacts/lists": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Contacts" ], "summary": "Create a contact list", "description": "Creates a new contact list.", "operationId": "createContactList", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateListRequest" } } }, "required": true }, "responses": { "201": { "description": "Contact list is created", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ListData" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "501": { "$ref": "#/components/responses/RequestNotRecognised" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServerUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nBODY=$(cat <<'EOF'\n{\n \"name\": \"My group\",\n \"alias\": \"Group1\"\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/api/v1/contacts/lists\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n var body = \"\"\"\n {\n \"name\": \"My group\",\n \"alias\": \"Group1\"\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/api/v1/contacts/lists\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PostAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\n String body = \"\"\"\n {\n \"name\": \"My group\",\n \"alias\": \"Group1\"\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/api/v1/contacts/lists\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"name\": \"My group\",\n \"alias\": \"Group1\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'My group',\n 'alias' => 'Group1'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/lists';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"name\": \"My group\",\n \"alias\": \"Group1\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/lists'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"name\" => \"My group\",\n \"alias\" => \"Group1\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/lists\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] }, "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Contacts" ], "summary": "Get contact lists page", "description": "Retrieves a paginated list of contact lists.", "operationId": "getContactListsPage", "parameters": [ { "name": "request", "in": "query", "required": true, "description": "Pagination and filter options for the contact lists page (page tokens, page size, and related filters).\n", "schema": { "$ref": "#/components/schemas/GetListsRequest" } } ], "responses": { "200": { "description": "Returns a contact lists page", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/PageTokenDtoListData" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "501": { "$ref": "#/components/responses/RequestNotRecognised" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServerUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nREQUEST=\"YOUR_REQUEST\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/api/v1/contacts/lists?request=${REQUEST}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var request = \"YOUR_REQUEST\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/api/v1/contacts/lists?request={request}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String request = \"YOUR_REQUEST\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/api/v1/contacts/lists\" + \"?\" + \"request=\" + request;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst request = 'YOUR_REQUEST';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists?request=${request}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst listId = 'YOUR_LIST_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists/${listId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst listId = 'YOUR_LIST_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists/${listId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst listId = 'YOUR_LIST_ID';\n\nconst body = {\n \"name\": \"My list\",\n \"alias\": \"List1\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists/${listId}`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'My list',\n 'alias' => 'List1'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/lists/' . $listId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nlist_id = \"YOUR_LIST_ID\"\n\nbody = {\n \"name\": \"My list\",\n \"alias\": \"List1\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/lists/{list_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nlist_id = \"YOUR_LIST_ID\"\n\nbody = {\n \"name\" => \"My list\",\n \"alias\" => \"List1\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/lists/#{list_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/api/v1/contacts/lists/{listId}/contacts": { "patch": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Contacts" ], "summary": "Add or remove multiple contacts to/from a list", "description": "Adds or removes multiple contacts to or from a contact list.", "operationId": "modifyContactsInContactList", "parameters": [ { "name": "listId", "in": "path", "description": "Contact list id in UUID format", "required": true, "schema": { "type": "string", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateContactsListRequest" } } }, "required": true }, "responses": { "200": { "description": "Contacts added/removed to/from list", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ListData" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "501": { "$ref": "#/components/responses/RequestNotRecognised" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServerUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nLIST_ID=\"YOUR_LIST_ID\"\n\nBODY=$(cat <<'EOF'\n{\n \"contactsToAddIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ],\n \"contactsToRemoveIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ]\n}\nEOF\n)\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X PATCH \"${API_HOST}/api/v1/contacts/lists/${LIST_ID}/contacts\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\" \\\n -H \"Content-Type: application/json\" \\\n -d \"${BODY}\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var listId = \"YOUR_LIST_ID\";\n\n var body = \"\"\"\n {\n \"contactsToAddIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ],\n \"contactsToRemoveIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/api/v1/contacts/lists/{listId}/contacts\";\n using var content = new StringContent(body, Encoding.UTF8, \"application/json\");\n using var response = await client.PatchAsync(url, content);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String listId = \"YOUR_LIST_ID\";\n\n String body = \"\"\"\n {\n \"contactsToAddIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ],\n \"contactsToRemoveIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ]\n }\n \"\"\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/api/v1/contacts/lists/\" + listId + \"/contacts\";\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.header(\"Content-Type\", \"application/json\");\n builder.method(\"PATCH\", HttpRequest.BodyPublishers.ofString(body));\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst listId = 'YOUR_LIST_ID';\n\nconst body = {\n \"contactsToAddIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ],\n \"contactsToRemoveIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ]\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists/${listId}/contacts`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n '025e93d3-051b-43f9-b12e-4b5842228dee'\n ],\n 'contactsToRemoveIds' => [\n '025e93d3-051b-43f9-b12e-4b5842228dee'\n ]\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/lists/' . $listId . '/contacts';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nlist_id = \"YOUR_LIST_ID\"\n\nbody = {\n \"contactsToAddIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ],\n \"contactsToRemoveIds\": [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/lists/{list_id}/contacts'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\nlist_id = \"YOUR_LIST_ID\"\n\nbody = {\n \"contactsToAddIds\" => [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ],\n \"contactsToRemoveIds\" => [\n \"025e93d3-051b-43f9-b12e-4b5842228dee\"\n ]\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/lists/#{list_id}/contacts\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } }, "/api/v1/contacts/lists/{listId}/contacts/{contactId}": { "post": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Contacts" ], "summary": "Add contact to a list", "description": "Adds a contact to a contact list.", "operationId": "addContactToContactList", "parameters": [ { "name": "listId", "in": "path", "description": "Contact list id in UUID format", "required": true, "schema": { "type": "string", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, { "name": "contactId", "in": "path", "description": "Contact id to remove in UUID format", "required": true, "schema": { "type": "string", "format": "uuid", "example": "4a03d2d8-1f85-463f-bdb4-2891c17258a7" } } ], "responses": { "200": { "description": "Contacts have been added", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ListData" } } } }, "201": { "description": "Created", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ListData" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "501": { "$ref": "#/components/responses/RequestNotRecognised" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServerUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nLIST_ID=\"YOUR_LIST_ID\"\nCONTACT_ID=\"YOUR_CONTACT_ID\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X POST \"${API_HOST}/api/v1/contacts/lists/${LIST_ID}/contacts/${CONTACT_ID}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var listId = \"YOUR_LIST_ID\";\n var contactId = \"YOUR_CONTACT_ID\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/api/v1/contacts/lists/{listId}/contacts/{contactId}\";\n using var response = await client.SendAsync(new HttpRequestMessage(new HttpMethod(\"POST\"), url));\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String listId = \"YOUR_LIST_ID\";\n String contactId = \"YOUR_CONTACT_ID\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/api/v1/contacts/lists/\" + listId + \"/contacts/\" + contactId;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"POST\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst listId = 'YOUR_LIST_ID';\nconst contactId = 'YOUR_CONTACT_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists/${listId}/contacts/${contactId}`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst listId = 'YOUR_LIST_ID';\nconst contactId = 'YOUR_CONTACT_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/lists/${listId}/contacts/${contactId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nconst body = {\n \"label\": \"Contact name\",\n \"mergeTag\": \"contact_name\",\n \"maxLength\": 30,\n \"type\": \"DATE\"\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/custom-fields`, {\n method: 'POST',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Contact name',\n 'mergeTag' => 'contact_name',\n 'maxLength' => 30,\n 'type' => 'DATE'\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/custom-fields';\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"label\": \"Contact name\",\n \"mergeTag\": \"contact_name\",\n \"maxLength\": 30,\n \"type\": \"DATE\"\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/custom-fields'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='POST')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\n\nbody = {\n \"label\" => \"Contact name\",\n \"mergeTag\" => \"contact_name\",\n \"maxLength\" => 30,\n \"type\" => \"DATE\"\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/custom-fields\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Post.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] }, "get": { "security": [ { "basic_auth": [] }, { "hmac_auth": [] } ], "tags": [ "Contacts" ], "summary": "Get custom fields page", "description": "Retrieves a paginated list of custom fields.", "operationId": "getCustomFieldsPage", "parameters": [ { "name": "request", "in": "query", "required": true, "description": "Pagination and filter options for the custom fields page (page tokens, page size, and related filters).\n", "schema": { "$ref": "#/components/schemas/GetCustomFieldsRequest" } } ], "responses": { "200": { "description": "Returns a custom fields page", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/PageTokenDtoCustomFieldData" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "501": { "$ref": "#/components/responses/RequestNotRecognised" }, "502": { "$ref": "#/components/responses/BadGateway" }, "503": { "$ref": "#/components/responses/ServerUnavailable" }, "504": { "$ref": "#/components/responses/GatewayTimeout" } }, "x-codeSamples": [ { "lang": "curl", "label": "curl", "source": "#!/usr/bin/env bash\nAPI_KEY=\"YOUR_API_KEY\"\nAPI_SECRET=\"YOUR_API_SECRET\"\nAPI_HOST=\"YOUR_API_HOST\" # Set YOUR_API_HOST to the regional host from the servers section in the docs\nREQUEST=\"YOUR_REQUEST\"\n\n# HMAC authentication is also supported instead of Basic\nBASIC_AUTH=$(printf '%s' \"${API_KEY}:${API_SECRET}\" | base64 | tr -d '\\n')\ncurl -sS -X GET \"${API_HOST}/api/v1/contacts/custom-fields?request=${REQUEST}\" \\\n -H \"Authorization: Basic ${BASIC_AUTH}\" \\\n -H \"Accept: application/json\"\n" }, { "lang": "C#", "label": "C#", "source": "using System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\nclass Program\n{\n static async Task Main()\n {\n var apiKey = \"YOUR_API_KEY\";\n var apiSecret = \"YOUR_API_SECRET\";\n var apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n var request = \"YOUR_REQUEST\";\n\n // HMAC authentication is also supported instead of Basic\n using var client = new HttpClient();\n var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($\"{apiKey}:{apiSecret}\"));\n client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", credentials);\n client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n var url = $\"{apiHost}/api/v1/contacts/custom-fields?request={request}\";\n using var response = await client.GetAsync(url);\n Console.WriteLine((int)response.StatusCode);\n Console.WriteLine(await response.Content.ReadAsStringAsync());\n }\n}\n" }, { "lang": "Java", "label": "Java", "source": "import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Sample {\n public static void main(String[] args) throws Exception {\n String apiKey = \"YOUR_API_KEY\";\n String apiSecret = \"YOUR_API_SECRET\";\n String apiHost = \"YOUR_API_HOST\"; // Set YOUR_API_HOST to the regional host from the servers section in the docs\n String request = \"YOUR_REQUEST\";\n\n // HMAC authentication is also supported instead of Basic\n String auth = Base64.getEncoder().encodeToString((apiKey + \":\" + apiSecret).getBytes(StandardCharsets.UTF_8));\n String url = apiHost + \"/api/v1/contacts/custom-fields\" + \"?\" + \"request=\" + request;\n HttpClient client = HttpClient.newHttpClient();\n HttpRequest.Builder builder = HttpRequest.newBuilder()\n .uri(URI.create(url))\n .header(\"Authorization\", \"Basic \" + auth)\n .header(\"Accept\", \"application/json\");\n builder.method(\"GET\", HttpRequest.BodyPublishers.noBody());\n HttpResponse response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst request = 'YOUR_REQUEST';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/custom-fields?request=${request}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst customFieldId = 'YOUR_CUSTOM_FIELD_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/custom-fields/${customFieldId}`, {\n method: 'GET',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst customFieldId = 'YOUR_CUSTOM_FIELD_ID';\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/custom-fields/${customFieldId}`, {\n method: 'DELETE',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n },\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " response = client.send(builder.build(), HttpResponse.BodyHandlers.ofString());\n System.out.println(response.statusCode());\n System.out.println(response.body());\n }\n}\n" }, { "lang": "JavaScript", "label": "JavaScript", "source": "const apiKey = 'YOUR_API_KEY';\nconst apiSecret = 'YOUR_API_SECRET';\nconst apiHost = 'YOUR_API_HOST'; // Set YOUR_API_HOST to the regional host from the servers section in the docs\nconst customFieldId = 'YOUR_CUSTOM_FIELD_ID';\n\nconst body = {\n \"label\": \"Contact name\",\n \"maxLength\": 30\n};\n\n// HMAC authentication is also supported instead of Basic\nconst auth = Buffer.from(`${apiKey}:${apiSecret}`).toString('base64');\n\nconst response = await fetch(`${apiHost}/api/v1/contacts/custom-fields/${customFieldId}`, {\n method: 'PATCH',\n headers: {\n Authorization: `Basic ${auth}`,\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n});\n\nconsole.log(response.status);\nconsole.log(await response.text());\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Contact name',\n 'maxLength' => 30\n];\n\n// HMAC authentication is also supported instead of Basic\n$url = $apiHost . '/api/v1/contacts/custom-fields/' . $customFieldId;\n$headers = [\n 'Authorization: Basic ' . base64_encode($apiKey . ':' . $apiSecret),\n 'Accept: application/json',\n 'Content-Type: application/json',\n];\n\n$ch = curl_init($url);\ncurl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));\n\n$response = curl_exec($ch);\n$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\necho $status, PHP_EOL;\necho $response, PHP_EOL;\n" }, { "lang": "Python", "label": "Python", "source": "import base64\nimport json\nimport urllib.request\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\ncustom_field_id = \"YOUR_CUSTOM_FIELD_ID\"\n\nbody = {\n \"label\": \"Contact name\",\n \"maxLength\": 30\n}\n\n# HMAC authentication is also supported instead of Basic\nauth = base64.b64encode(f'{api_key}:{api_secret}'.encode()).decode()\nurl = f'{api_host}/api/v1/contacts/custom-fields/{custom_field_id}'\nheaders = {\n 'Authorization': f'Basic {auth}',\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n}\n\ndata = json.dumps(body).encode('utf-8')\nrequest = urllib.request.Request(url, data=data, headers=headers, method='PATCH')\n\nwith urllib.request.urlopen(request) as response:\n print(response.status)\n print(response.read().decode())\n" }, { "lang": "Ruby", "label": "Ruby", "source": "require 'net/http'\nrequire 'json'\nrequire 'base64'\nrequire 'uri'\n\napi_key = 'YOUR_API_KEY'\napi_secret = 'YOUR_API_SECRET'\napi_host = 'YOUR_API_HOST' # Set YOUR_API_HOST to the regional host from the servers section in the docs\ncustom_field_id = \"YOUR_CUSTOM_FIELD_ID\"\n\nbody = {\n \"label\" => \"Contact name\",\n \"maxLength\" => 30\n}\n\n# HMAC authentication is also supported instead of Basic\nuri = URI.parse(\"#{api_host}/api/v1/contacts/custom-fields/#{custom_field_id}\")\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = uri.scheme == 'https'\n\nrequest = Net::HTTP::Patch.new(uri)\nrequest['Authorization'] = 'Basic ' + Base64.strict_encode64(\"#{api_key}:#{api_secret}\")\nrequest['Accept'] = 'application/json'\nrequest['Content-Type'] = 'application/json'\nrequest.body = JSON.generate(body)\n\nresponse = http.request(request)\nputs response.code\nputs response.body\n" } ] } } }, "webhooks": { "deliveryReport": { "post": { "security": [], "tags": [ "Webhook Payloads" ], "summary": "Delivery report webhook", "description": "Sent to the `url` configured on a webhook subscribed to one or more delivery report events (`ENROUTE_DR`, `SUBMITTED_DR`, `DELIVERED_DR`, `EXPIRED_DR`, `REJECTED_DR`, `FAILED_DR` — see the Create webhook operation under Webhooks Management). The body shown here is the default/example shape produced by the sample `template` on that operation; the actual JSON structure is fully controlled by the `template` you configure, so treat this as a suggested default rather than a fixed contract.\n\nIf your account has `API_SECURE_CALLBACKS` enabled with an active signature key (see Signature Key Management), this request is signed so you can verify it came from Sinch. The signature is carried in these headers:\n\n- `X-MessageMedia-Signature` — the signed digest, base64-encoded.\n- `X-MessageMedia-Digest-Type` — digest algorithm used, for example `SHA-512`.\n- `X-MessageMedia-Cipher-Type` — signing algorithm used, for example `RSA`.\n- `X-MessageMedia-Key-Id` — UUID of the signing key, so you can select the right public key from Signature Key Management.\n\nThe signed value is the request line, followed by the `Date` header sent on the request, followed by the request body.", "operationId": "DeliveryReportWebhook", "requestBody": { "description": "Delivery report webhook payload.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeliveryReportWebhookPayload" }, "example": { "delivery_report_id": "01e1fa0a-6e27-4945-9cdb-18644b4de043", "source_number": "+61491570156", "date_received": "2016-11-03T11:49:02.807Z", "status": "delivered", "delay": "0", "submitted_date": "2016-11-03T11:49:02.807Z", "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "original_text": "Hello back", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount001" }, "error_code": "220", "metadata": { "myKey": "myValue" } } } } }, "responses": { "200": { "description": "Your endpoint acknowledged the delivery report. Any 2xx response is treated as successful delivery." }, "400": { "description": "Your endpoint returned an error response. Delivery is retried according to the `retries` / `retry_delay` configured on the webhook (see Create webhook)." } } } }, "smsReceived": { "post": { "security": [], "tags": [ "Webhook Payloads" ], "summary": "SMS received webhook", "description": "Sent to the `url` configured on a webhook subscribed to `RECEIVED_SMS` (see the Create webhook operation under Webhooks Management). `OPT_OUT_SMS` is dispatched through a separate code path with its own shape — see the Opt-out webhook. The body shown here is the default/example shape produced by the sample `template` on that operation; the actual JSON structure is fully controlled by the `template` you configure, so treat this as a suggested default rather than a fixed contract.\n\nIf your account has `API_SECURE_CALLBACKS` enabled with an active signature key (see Signature Key Management), this request is signed so you can verify it came from Sinch. The signature is carried in these headers:\n\n- `X-MessageMedia-Signature` — the signed digest, base64-encoded.\n- `X-MessageMedia-Digest-Type` — digest algorithm used, for example `SHA-512`.\n- `X-MessageMedia-Cipher-Type` — signing algorithm used, for example `RSA`.\n- `X-MessageMedia-Key-Id` — UUID of the signing key, so you can select the right public key from Signature Key Management.\n\nThe signed value is the request line, followed by the `Date` header sent on the request, followed by the request body.", "operationId": "SmsReceivedWebhook", "requestBody": { "description": "SMS received webhook payload.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SmsReceivedWebhookPayload" }, "example": { "account_id": "DeveloperPortal7000", "reply_id": "a175e797-2b54-468b-9850-41a3eab32f74", "destination_number": "+61491593156", "source_number": "+61491570156", "date_received": "2016-12-07T08:44:00.850Z", "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "content": "Hello Derpina", "metadata": { "myKey": "myValue" } } } } }, "responses": { "200": { "description": "Your endpoint acknowledged the reply. Any 2xx response is treated as successful delivery." }, "400": { "description": "Your endpoint returned an error response. Delivery is retried according to the `retries` / `retry_delay` configured on the webhook (see Create webhook)." } } } }, "mmsReceived": { "post": { "security": [], "tags": [ "Webhook Payloads" ], "summary": "MMS received webhook", "description": "Sent to the `url` configured on a webhook subscribed to `RECEIVED_MMS` (see the Create webhook operation under Webhooks Management). Same shape as the SMS received webhook, except that the sample `template` branches on media: it emits `attachments` when the reply carries media and falls back to `content` when it does not, never both. The body shown here is the default/example shape produced by the sample `template` on that operation; the actual JSON structure is fully controlled by the `template` you configure, so treat this as a suggested default rather than a fixed contract.\n\nIf your account has `API_SECURE_CALLBACKS` enabled with an active signature key (see Signature Key Management), this request is signed so you can verify it came from Sinch. The signature is carried in these headers:\n\n- `X-MessageMedia-Signature` — the signed digest, base64-encoded.\n- `X-MessageMedia-Digest-Type` — digest algorithm used, for example `SHA-512`.\n- `X-MessageMedia-Cipher-Type` — signing algorithm used, for example `RSA`.\n- `X-MessageMedia-Key-Id` — UUID of the signing key, so you can select the right public key from Signature Key Management.\n\nThe signed value is the request line, followed by the `Date` header sent on the request, followed by the request body.", "operationId": "MmsReceivedWebhook", "requestBody": { "description": "MMS received webhook payload.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MmsReceivedWebhookPayload" }, "examples": { "withAttachments": { "summary": "Reply carrying media — emits `attachments`", "value": { "account_id": "DeveloperPortal7000", "reply_id": "a175e797-2b54-468b-9850-41a3eab32f74", "destination_number": "+61491593156", "source_number": "+61491570156", "date_received": "2016-12-07T08:44:00.850Z", "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "attachments": [ { "content_type": "image/png", "content": "dGVzdA==", "original_name": "file.png" } ], "metadata": { "myKey": "myValue" } } }, "textOnly": { "summary": "Reply with no media — falls back to `content`", "value": { "account_id": "DeveloperPortal7000", "reply_id": "a175e797-2b54-468b-9850-41a3eab32f74", "destination_number": "+61491593156", "source_number": "+61491570156", "date_received": "2016-12-07T08:44:00.850Z", "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "content": "Hello back", "metadata": { "myKey": "myValue" } } } } } } }, "responses": { "200": { "description": "Your endpoint acknowledged the reply. Any 2xx response is treated as successful delivery." }, "400": { "description": "Your endpoint returned an error response. Delivery is retried according to the `retries` / `retry_delay` configured on the webhook (see Create webhook)." } } } }, "optOut": { "post": { "security": [], "tags": [ "Webhook Payloads" ], "summary": "Opt-out webhook", "description": "Sent to the `url` configured on a webhook subscribed to `OPT_OUT_SMS` (see the Create webhook operation under Webhooks Management). No sample `template` exists in current prose for this event, so the body shown here is a suggested shape built from the template variables available to opt-out notifications, rather than a transcribed default.\n\nThis event is dispatched as a notification with its own `$notificationId`, not as a reply. The `$replyId` / `$moId` variables used by the `RECEIVED_SMS` and `RECEIVED_MMS` templates are **not available** here — a template referencing them renders the literal text `$replyId` instead of an ID. Use `$notificationId` instead.\n\nThe actual JSON structure sent to your `url` is fully controlled by the `template` you configure.\n\nIf your account has `API_SECURE_CALLBACKS` enabled with an active signature key (see Signature Key Management), this request is signed so you can verify it came from Sinch. The signature is carried in these headers:\n\n- `X-MessageMedia-Signature` — the signed digest, base64-encoded.\n- `X-MessageMedia-Digest-Type` — digest algorithm used, for example `SHA-512`.\n- `X-MessageMedia-Cipher-Type` — signing algorithm used, for example `RSA`.\n- `X-MessageMedia-Key-Id` — UUID of the signing key, so you can select the right public key from Signature Key Management.\n\nThe signed value is the request line, followed by the `Date` header sent on the request, followed by the request body.", "operationId": "OptOutWebhook", "requestBody": { "description": "Opt-out webhook payload.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OptOutWebhookPayload" }, "example": { "notification_id": "3e6e6b1a-6c1d-4b1a-9c1e-6f1a6b1a6c1d", "account_id": "DeveloperPortal7000", "destination_number": "+61491593156", "source_number": "+61491570156", "date_received": "2016-12-07T08:44:00.850Z", "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "content": "STOP", "metadata": { "myKey": "myValue" } } } } }, "responses": { "200": { "description": "Your endpoint acknowledged the opt-out notification. Any 2xx response is treated as successful delivery." }, "400": { "description": "Your endpoint returned an error response. Delivery is retried according to the `retries` / `retry_delay` configured on the webhook (see Create webhook)." } } } } }, "components": { "schemas": { "Format": { "title": "Format", "enum": [ "SMS", "TTS", "MMS" ], "type": "string", "description": "Filter results by message format, using enumerable MessageType.", "example": "SMS" }, "format": { "title": "MessageType", "type": "array", "deprecated": true, "items": { "type": "string", "enum": [ "MMS", "SMS", "TTS", "RCS", "CHANNEL" ] }, "description": "Format of message type. Deprecated — use the `channels` parameter instead, which provides equivalent and expanded message-type filtering.", "example": [ "MMS", "TTS" ] }, "ApiError": { "required": [ "detail", "title", "type", "uuid" ], "type": "object", "properties": { "uuid": { "type": "string", "description": "Error id in UUID format", "format": "uuid" }, "type": { "type": "string", "description": "Error type", "enum": [ "validation", "not_found", "method_not_allowed", "conflict", "payload_too_large", "unsupported_media_type", "message_not_readable", "internal_server_error", "request_not_recognised", "forbidden", "bad_gateway", "payment_required", "unauthorized", "unknown" ] }, "title": { "type": "string", "description": "Error title" }, "detail": { "type": "string", "description": "Error additional details" } }, "description": "Api error data" }, "InvalidInputApiError": { "required": [ "detail", "invalidFields", "title", "type", "uuid" ], "type": "object", "properties": { "uuid": { "type": "string", "description": "Error id in UUID format", "format": "uuid" }, "type": { "type": "string", "description": "Error type", "enum": [ "validation", "not_found", "method_not_allowed", "conflict", "payload_too_large", "unsupported_media_type", "message_not_readable", "internal_server_error", "request_not_recognised", "forbidden", "bad_gateway", "payment_required", "unauthorized", "unknown" ] }, "title": { "type": "string", "description": "Error title" }, "detail": { "type": "string", "description": "Error additional details" }, "invalidFields": { "type": "array", "description": "List of invalid fields", "items": { "$ref": "#/components/schemas/InvalidInputField" } } }, "description": "Invalid input error data" }, "InvalidInputField": { "required": [ "code", "name", "reason" ], "type": "object", "properties": { "name": { "type": "string", "description": "Invalid input field name" }, "channelType": { "type": "string", "description": "Invalid channel type", "enum": [ "PHONE", "WHATSAPP", "GBM", "INSTAGRAM", "FACEBOOK", "EMAIL" ] }, "code": { "type": "string", "description": "Invalid input value code", "enum": [ "must_not_be_empty", "must_be_empty", "must_not_be_null", "invalid_length", "duplicated_value", "invalid_format", "type_mismatch", "missing_parameter", "invalid_reference", "incorrect_operation", "no_such_pattern", "constraint_violation" ] }, "reason": { "type": "string", "description": "Error message" }, "invalidIds": { "type": "array", "items": { "type": "string" } } }, "description": "Invalid input field" }, "MessageDirection": { "title": "MessageDirection", "type": "string", "enum": [ "inbound", "outbound", "all" ], "example": "all", "description": "The type of messages to include in the report." }, "metakeyrequest": { "title": "metakeyrequest", "type": "object", "required": [ "start_date", "end_date" ], "properties": { "page": { "type": "number", "description": "Page number for paging through paginated result sets.", "example": 2 }, "page_size": { "type": "number", "description": "Number of results to return in a page for paginated result sets.", "example": 15 }, "start_date": { "type": "string", "description": "Start date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "example": "2022-12-12T00:00:00.000z" }, "end_date": { "type": "string", "description": "End date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "example": "2022-12-14T00:00:00.000z" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "accounts": { "type": "array", "items": { "type": "string" }, "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts.", "example": [ "Account1", "Account2" ] } } }, "metakeyresponse": { "title": "metakeyresponse", "properties": { "keys": { "type": "array", "items": { "type": "string" }, "example": [ "meta1", "meta2", "meta3" ] } } }, "400response": { "title": "Bad request", "required": [ "message", "details" ], "type": "object", "properties": { "message": { "type": "string" }, "details": { "type": "array", "items": { "type": "string" }, "description": "Additional error detail messages." } }, "example": { "message": "Request failed to parse correctly. Please ensure input is valid and try again.", "details": [ "Failed to parse message body." ] } }, "MessageStatus": { "title": "MessageStatus", "type": "string", "enum": [ "UNDEFINED", "QUEUED", "PROCESSING", "PROCESSED", "FAILED", "SCHEDULED", "CANCELLED", "DELIVERED", "EXPIRED", "ENROUTE", "HELD", "SUBMITTED", "REJECTED", "READ" ], "example": "DELIVERED", "description": "An enumerable list of potential message statuses." }, "channels": { "title": "Channels", "description": "Filter the report by one or more channels.", "type": "array", "items": { "type": "string", "enum": [ "SMS", "MMS", "TTS", "RCS", "WHATSAPP", "CHANNEL" ] }, "example": [ "SMS", "WHATSAPP" ] }, "detailrequest": { "title": "detailrequest", "required": [ "start_date", "end_date" ], "type": "object", "properties": { "start_date": { "description": "Start date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "type": "string", "example": "2022-12-12T00:00:00.000z" }, "end_date": { "description": "End date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format, and after the requested start_date.", "type": "string", "example": "2022-12-14T00:00:00.000z" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "timezone": { "description": "The timezone of the messages to include, using the name of the region.", "type": "string", "example": "Australia/Sydney" }, "source": { "description": "Filter results by source address.", "type": "string", "example": "+61555555555" }, "sources": { "description": "Filter results by multiple source addresses. This property overrides the `source` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "destination": { "description": "Filter results by destination address.", "type": "string", "example": "+61555555555" }, "destinations": { "description": "Filter results by multiple destination addresses. This property overrides the `destination` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "metadata_key": { "description": "Filter results for messages that include a metadata key.", "type": "string", "example": "broadcastId" }, "metadata_value": { "description": "Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided.", "type": "string", "example": "ABC" }, "metadata_values": { "description": "Filter results for messages that include a metadata key containing these values. This parameter overrides the metadata_value property. If this parameter is provided, the metadata_key parameter must also be provided.", "type": "array", "items": { "type": "string" }, "example": [ "meta1", "meta2" ] }, "accounts": { "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts.", "type": "array", "items": { "type": "string" }, "example": [ "Account1", "Account2" ] }, "status": { "description": "An array of message statuses", "type": "array", "items": { "$ref": "#/components/schemas/MessageStatus" } }, "opt_out": { "description": "Filter the report to only include messages that triggered an opt-out", "type": "boolean", "example": true }, "mms_media": { "description": "Filter results by mms media.", "type": "boolean", "example": true }, "message_format": { "$ref": "#/components/schemas/format" }, "channels": { "$ref": "#/components/schemas/channels" }, "page": { "description": "Page number for paging through paginated result sets.", "type": "integer", "minimum": 0, "example": 0 }, "page_size": { "description": "Number of results to return in a page for paginated result sets.", "type": "integer", "minimum": 1, "maximum": 100, "example": 20 } } }, "Status": { "title": "Status", "enum": [ "undefined", "queued", "processing", "processed", "failed", "scheduled", "cancelled", "delivered", "expired", "enroute", "held", "submitted", "rejected", "read" ], "type": "string", "description": "The status of the message", "example": "enroute" }, "RichMessageType": { "title": "RichMessageType", "type": "string", "description": "The type of rich message. Supported from 09/Sep/2025, and this data is available only for reports starting from this date.", "enum": [ "TEXT_MESSAGE", "MEDIA_MESSAGE", "LOCATION_MESSAGE", "CHOICE_RESPONSE_MESSAGE", "MEDIA_CARD_MESSAGE", "CARD_MESSAGE", "CAROUSEL_MESSAGE", "CHOICE_MESSAGE" ], "example": "TEXT_MESSAGE" }, "DetailReportMessageRecord": { "title": "DetailReportMessageRecord", "type": "object", "properties": { "message_id": { "type": "string", "description": "Unique ID of this message", "format": "uuid" }, "format": { "$ref": "#/components/schemas/Format" }, "timestamp": { "type": "string", "description": "Timestamp of this message", "example": "2017-02-10T16:30:00" }, "delivered_timestamp": { "type": "string", "description": "Time that this message was delivered", "example": "2017-02-10T16:30:00" }, "last_status_update": { "type": "string", "description": "Last time this message's status was updated", "example": "2017-02-10T16:30:00" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "status": { "$ref": "#/components/schemas/Status" }, "status_code": { "type": "number", "description": "The response code of the status", "example": 220 }, "status_description": { "type": "string", "description": "The status of the message", "example": "Message delivered" }, "source_address": { "type": "string", "example": "+61490246135" }, "destination_address": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Destination number of the message", "example": "+6149123654" }, "destination_address_country": { "type": "string", "description": "Country of the destination address", "example": "AU" }, "source_address_country": { "type": "string", "description": "Country of the source address", "example": "AU" }, "in_response_to": { "type": "string", "description": "The ID of the message this message is a reply to, if any.", "format": "uuid" }, "action": { "type": "string", "description": "The action taken on the message, if any." }, "media_url": { "type": "string", "description": "URL of the media attached to this message, if any (MMS/RCS)." }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the message", "example": "Hello world!" }, "account_id": { "type": "string", "description": "The ID of the account", "example": "account_1" }, "units": { "type": "number", "description": "The amount of messages received", "example": 1 }, "billing_category": { "type": "string", "description": "The billing category applied to this RCS message (e.g. RCS_BASIC, RCS_SINGLE, RCS_RICH, RCS_RICH_MEDIA). Supported from 5/Feb/2026. This field is only available for RCS messages and only for messages sent on or after this date.", "example": "RCS_BASIC" }, "message_type": { "$ref": "#/components/schemas/RichMessageType" }, "metadata": { "type": "array", "description": "Metadata for the message as a list of key/value pairs. Each key can be up to 100 characters long and each value can be up to 256 characters long.\n```\n[\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n]\n```", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } } }, "example": [ { "key": "myKey", "value": "myValue" }, { "key": "anotherKey", "value": "anotherValue" } ] } } }, "Paginate": { "title": "Pagination", "type": "object", "properties": { "page": { "type": "number", "example": 0 }, "page_size": { "type": "number", "example": 20 }, "has_next": { "type": "boolean", "example": false } } }, "detailresponse": { "title": "detailresponse", "type": "object", "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/DetailReportMessageRecord" } }, "pagination": { "$ref": "#/components/schemas/Paginate" } } }, "403response": { "title": "403 response", "required": [ "message" ], "type": "object", "properties": { "message": { "type": "string" } }, "example": { "message": "Invalid authentication credentials" } }, "GroupByInsightField": { "title": "GroupByInsightField", "enum": [ "ACCOUNT", "DAY", "WEEK", "MONTH", "YEAR", "METADATA_KEY", "METADATA_VALUE", "STATUS", "COUNTRY", "CHANNEL", "POSTBACK_DATA", "MESSAGE_TYPE" ], "type": "string", "example": "DAY" }, "insightsrequest": { "title": "insightsrequest", "required": [ "start_date", "end_date", "timezone" ], "type": "object", "properties": { "start_date": { "description": "Start date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format and may include precise time values (e.g., milliseconds).", "type": "string", "example": "2022-12-12T01:01:01.001z" }, "end_date": { "description": "End date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format, and after the requested start_date and may include precise time values (e.g., milliseconds).", "type": "string", "example": "2022-12-14T01:01:01.001z" }, "timezone": { "description": "The timezone of the messages to include, using the name of the region.", "type": "string", "example": "Australia/Sydney" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "source": { "description": "Filter results by source address.", "type": "string", "example": "+61555555555" }, "sources": { "description": "Filter results by multiple source addresses. This property overrides the `source` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "destination": { "description": "Filter results by destination address.", "type": "string", "example": "+61555555555" }, "destinations": { "description": "Filter results by multiple destination addresses. This property overrides the `destination` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "addresses": { "description": "Filter messages where source OR destination matches one of the provided values. This parameter can only be set when `direction` is `all` and cannot be used in the same request as the `source`, `destination`, `sources`, or `destinations` parameters.", "type": "array", "items": { "type": "string" }, "example": [ "+61400000001", "+61400000002" ] }, "metadata_key": { "description": "Filter results for messages that include a metadata key. Can be used independently for searching.", "type": "string", "example": "broadcastId" }, "metadata_value": { "description": "Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided. Cannot be used together with metadata_values.", "type": "string", "example": "ABC" }, "metadata_values": { "description": "Filter results for messages that include a metadata key containing these values. Must be used together with metadata_key. Cannot be used together with metadata_value.", "type": "array", "items": { "type": "string" }, "example": [ "meta1", "meta2" ] }, "accounts": { "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts.", "type": "array", "items": { "type": "string" }, "example": [ "account1", "account2" ] }, "status": { "description": "An array of message statuses.", "type": "array", "items": { "$ref": "#/components/schemas/MessageStatus" }, "example": [ "DELIVERED", "ENROUTE" ] }, "opt_out": { "description": "Filter the report to only include messages that triggered an opt-out", "type": "boolean", "example": true }, "channels": { "description": "Filter the report by one or more message channels. Supported from 14/Aug/2025, and filtering by channels is available only for reports starting from this date.", "type": "array", "items": { "type": "string", "enum": [ "SMS", "MMS", "TTS", "RCS", "WHATSAPP", "CHANNEL" ] }, "example": [ "SMS", "WHATSAPP" ] }, "group_by": { "description": "Defines available fields for grouping insights reports. COUNTRY and CHANNEL are supported from 14/Aug/2025, and POSTBACK_DATA is supported from 16/Sep/2025, with data available only from those dates onward.", "type": "array", "items": { "$ref": "#/components/schemas/GroupByInsightField" }, "example": [ "WEEK", "ACCOUNT" ] } } }, "insightssubitemresponse": { "title": "insightssubitemresponse", "type": "object", "properties": { "date": { "type": "string", "description": "One or more dates separated by a comma, e.g. 2022-05-18,2022-05-19", "example": "2020-11-01" }, "group": { "type": "string", "example": "2020-11-01" }, "total_sent": { "type": "number", "example": 20 }, "total_received": { "type": "number", "example": 0 }, "total_billing_units": { "type": "number", "example": 20 }, "total_opt_out": { "type": "number", "example": 0 } } }, "insightsitemresponse": { "title": "insightsitemresponse", "type": "object", "properties": { "group": { "type": "string", "example": "Account1" }, "date": { "type": "string", "description": "One or more dates seperated by a comma, e.g. 2022-05-18,2022-05-19", "example": "2020-11-01" }, "total_sent": { "type": "number", "example": 60 }, "total_received": { "type": "number", "example": 30 }, "total_billing_units": { "type": "number", "example": 90 }, "total_opt_out": { "type": "number", "example": 7 }, "sub_groups": { "type": "array", "items": { "$ref": "#/components/schemas/insightssubitemresponse" } } } }, "insightsresponse": { "title": "insightsresponse", "type": "object", "properties": { "summaries": { "type": "array", "items": { "$ref": "#/components/schemas/insightsitemresponse" } }, "total_sent": { "type": "number", "example": 100 }, "total_received": { "type": "number", "example": 50 }, "total_billing_units": { "type": "number", "example": 150 }, "total_opt_out": { "type": "number", "example": 10 } } }, "messaging_report_sort_by": { "title": "MessagingReportSortBy", "enum": [ "FORMAT", "DIRECTION", "STATUS", "SOURCE_ADDRESS", "DESTINATION_ADDRESS", "STATUS_CODE", "ACCOUNT_ID", "DESTINATION_ADDRESS_COUNTRY", "SOURCE_ADDRESS_COUNTRY", "TIMESTAMP" ], "type": "string", "description": "Field to sort results set by", "example": "TIMESTAMP" }, "messaging_report_sort_direction": { "title": "MessagingReportSortDirection", "enum": [ "ASCENDING", "DESCENDING" ], "type": "string", "description": "Order to sort results by.", "example": "ASCENDING" }, "ReportPeriod": { "title": "ReportPeriod", "enum": [ "TODAY", "YESTERDAY", "THIS_WEEK", "LAST_WEEK", "THIS_MONTH", "LAST_MONTH", "LAST_30_DAYS", "LAST_7_DAYS", "THIS_WEEKDAYS", "LAST_WEEKDAYS" ], "type": "string", "description": "Automatically set a date range based on the period value. Can't be combined with start_date and end_date.", "example": "THIS_WEEK" }, "asyncfieldsrequest": { "title": "asyncfieldsrequest", "type": "object", "required": [ "name", "display_name" ], "properties": { "name": { "type": "string", "example": "id", "description": "The `async/detail/fields` value from API." }, "display_name": { "type": "string", "example": "id", "description": "Any string that you want to see in the CSV file header." } } }, "deliveryOptionsBody": { "title": "deliveryOptionsBody", "type": "object", "properties": { "delivery_type": { "type": "string", "enum": [ "EMAIL" ], "description": "How to deliver the report.", "example": "EMAIL" }, "delivery_addresses": { "type": "array", "items": { "type": "string" }, "example": [ "email@example.com", "test@example.com" ], "description": "A list of email addresses to use as the recipient of the email. Only works for EMAIL delivery type" }, "delivery_format": { "type": "string", "enum": [ "CSV" ], "description": "Format of the report.", "example": "CSV" } }, "description": "A delivery option" }, "asyncsentmessagesdetailrequest": { "title": "asyncsentmessagesdetailrequest", "required": [ "end_date", "start_date" ], "type": "object", "properties": { "start_date": { "description": "Start date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "type": "string", "example": "2022-12-12T00:00:00.000z" }, "end_date": { "description": "End date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "type": "string", "example": "2022-12-14T00:00:00.000z" }, "timezone": { "description": "The timezone of the messages to include, using the name of the region.", "type": "string", "example": "Australia/Sydney" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "source": { "description": "Filter results by source address.", "type": "string", "example": "+61555555555" }, "sources": { "description": "Filter results by multiple source addresses. This property overrides the `source` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "destination": { "description": "Filter results by destination address.", "type": "string", "example": "+61555555555" }, "destinations": { "description": "Filter results by multiple destination addresses. This property overrides the `destination` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "addresses": { "description": "Filter messages where source OR destination matches one of the provided values. This parameter can only be set when `direction` is `all` and cannot be used in the same request as the `source`, `destination`, `sources`, or `destinations` parameters.", "type": "array", "items": { "type": "string" }, "example": [ "+61400000001", "+61400000002" ] }, "metadata_key": { "description": "Filter results for messages that include a metadata key. Can be used independently for searching.", "type": "string", "example": "broadcastId" }, "metadata_value": { "description": "Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided. Cannot be used together with metadata_values.", "type": "string", "example": "ABC" }, "metadata_values": { "description": "Filter results for messages that include a metadata key containing these values. Must be used together with metadata_key. Cannot be used together with metadata_value.", "type": "array", "items": { "type": "string" }, "example": [ "meta1", "meta2" ] }, "accounts": { "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts.", "type": "array", "items": { "type": "string" }, "example": [ "Account1", "Account2" ] }, "status": { "type": "array", "items": { "$ref": "#/components/schemas/MessageStatus" } }, "opt_out": { "description": "Filter the report to only include messages that triggered an opt-out", "type": "boolean", "example": true }, "message_format": { "$ref": "#/components/schemas/format" }, "channels": { "$ref": "#/components/schemas/channels" }, "sort_by": { "$ref": "#/components/schemas/messaging_report_sort_by" }, "sort_direction": { "$ref": "#/components/schemas/messaging_report_sort_direction" }, "period": { "$ref": "#/components/schemas/ReportPeriod" }, "include_contacts": { "type": "boolean", "description": "Whether to include contact details in the report.", "example": false }, "account_names": { "type": "array", "description": "A list of account label overrides for the accounts included in the report.", "items": { "type": "object", "properties": { "account_id": { "type": "string" }, "label": { "type": "string" } } } }, "label": { "type": "string", "description": "A label for this report." }, "user_id": { "type": "string", "description": "The ID of the user requesting the report." }, "is_support": { "type": "boolean", "description": "Whether the report is being requested by support on behalf of the account." }, "report_type": { "type": "string", "description": "The type of report being requested.", "enum": [ "DETAIL", "SUMMARY", "USER_USAGE", "SUB_ACCOUNT_USAGE", "GENERIC" ] }, "responded": { "type": "boolean", "description": "Filter results by whether the message received a response." }, "fields": { "description": "Can be used for async detail report to select the fields to export csv files", "type": "array", "items": { "$ref": "#/components/schemas/asyncfieldsrequest" } }, "delivery_options": { "description": "A list of options to configure the delivery of the report.", "type": "array", "items": { "$ref": "#/components/schemas/deliveryOptionsBody" } } } }, "asyncreportresponse": { "title": "asyncreportresponse", "type": "object", "properties": { "report_id": { "type": "string", "example": "51f0097f-90b2-4a59-ad88-a0fd93abaa82", "description": "The ID of the returned report." } } }, "GroupByField": { "title": "GroupByField", "enum": [ "ACCOUNT", "DAY", "WEEK", "MONTH", "YEAR", "METADATA_KEY", "METADATA_VALUE", "STATUS", "COUNTRY", "CHANNEL", "POSTBACK_DATA", "MESSAGE_TYPE" ], "type": "string", "example": "DAY" }, "asyncsummaryrequest": { "title": "asyncsummaryrequest", "required": [ "start_date", "end_date" ], "type": "object", "properties": { "start_date": { "description": "Start date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "type": "string", "example": "2022-12-12T00:00:00.000z" }, "end_date": { "description": "End date time for report window. By default, the timezone for this parameter will be taken from the account settings for the account associated with the credentials used to make the request, or the account included in the Account parameter. This can be overridden using the timezone parameter per request. The date must be in ISO8601 format.", "type": "string", "example": "2022-12-14T00:00:00.000z" }, "timezone": { "description": "The timezone of the messages to include, using the name of the region.", "type": "string", "example": "Australia/Sydney" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "source": { "description": "Filter results by source address.", "type": "string", "example": "+61555555555" }, "sources": { "description": "Filter results by multiple source addresses. This property overrides the `source` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "destination": { "description": "Filter results by destination address.", "type": "string", "example": "+61555555555" }, "destinations": { "description": "Filter results by multiple destination addresses. This property overrides the `destination` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "addresses": { "description": "Filter messages where source OR destination matches one of the provided values. This parameter can only be set when `direction` is `all` and cannot be used in the same request as the `source`, `destination`, `sources`, or `destinations` parameters.", "type": "array", "items": { "type": "string" }, "example": [ "+61400000001", "+61400000002" ] }, "channels": { "$ref": "#/components/schemas/channels" }, "metadata_key": { "description": "Filter results for messages that include a metadata key. Can be used independently for searching.", "type": "string", "example": "broadcastId" }, "metadata_value": { "description": "Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided. Cannot be used together with metadata_values.", "type": "string", "example": "ABC" }, "metadata_values": { "description": "Filter results for messages that include a metadata key containing these values. Must be used together with metadata_key. Cannot be used together with metadata_value.", "type": "array", "items": { "type": "string" }, "example": [ "meta1", "meta2" ] }, "accounts": { "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts.", "type": "array", "items": { "type": "string" }, "example": [ "Account1", "Account2" ] }, "status": { "type": "array", "items": { "$ref": "#/components/schemas/MessageStatus" }, "description": "A list of message statuses to filter the report by." }, "opt_out": { "description": "Filter the report to only include messages that triggered an opt-out", "type": "boolean", "example": false }, "group_by": { "description": "Group results by a list of values, from the enumerable table above.", "type": "array", "items": { "$ref": "#/components/schemas/GroupByField" }, "example": [ "WEEK", "ACCOUNT" ] }, "account_activity": { "type": "string", "description": "Filter accounts included in the report by activity level.", "enum": [ "ALL", "COLD", "ACTIVE" ], "example": "ALL" }, "delivery_options": { "description": "A list of options to configure the delivery of the report.", "type": "array", "items": { "$ref": "#/components/schemas/deliveryOptionsBody" } } } }, "reportstatusresponse": { "title": "reportstatusresponse", "type": "object", "properties": { "report_status": { "type": "string", "enum": [ "REQUESTED", "RUNNING", "FAILED", "CANCELLED", "DONE" ], "example": "DONE" } } }, "fieldsresponse": { "title": "fieldsresponse", "type": "object", "properties": { "fields": { "type": "array", "items": { "type": "string" }, "example": [ "id", "content", "meta1" ], "description": "An array of fields to be retrieved." } } }, "reporthistoryresponse": { "title": "reporthistoryresponse", "type": "object", "properties": { "report_id": { "type": "string", "format": "uuid", "description": "Unique identifier for the report.", "example": "51f0097f-90b2-4a59-ad88-a0fd93abaa82" }, "report_name": { "type": "string", "description": "The name of the report.", "example": "My Detail Report" }, "report_type": { "type": "string", "description": "The type of the report.", "enum": [ "DETAIL", "SUMMARY" ], "example": "DETAIL" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "requested_by": { "type": "string", "description": "The UUID of the user who requested the report.", "example": "MyAccount" }, "requested_at": { "type": "string", "format": "date-time", "description": "The date and time when the report was requested (ISO 8601).", "example": "2020-06-01T10:00:00.000Z" }, "updated_at": { "type": "string", "format": "date-time", "description": "The date and time when the report was last updated (ISO 8601).", "example": "2020-06-01T10:05:00.000Z" }, "status": { "type": "string", "description": "The current status of the report.", "enum": [ "REQUESTED", "RUNNING", "FAILED", "CANCELLED", "DONE" ], "example": "DONE" }, "account_id": { "type": "string", "description": "The account ID associated with the report.", "example": "MyAccount" }, "vendor_id": { "type": "string", "description": "The vendor ID associated with the report.", "example": "sinchonline" }, "s3_file_size": { "type": "integer", "format": "int64", "description": "The size of the report file in bytes.", "example": 204800 }, "request_data": { "type": "object", "description": "The original report request parameters that were submitted, as an echo of the request body/query used to generate this report." } } }, "reporthistoryresponses": { "title": "reporthistoryresponses", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/reporthistoryresponse" }, "description": "A list of report history items." }, "next_page_token": { "type": "string", "description": "A token to retrieve the next page of results. Absent if there are no more pages.", "example": "eyJyZXBvcnRJZCI6IjUxZjAwOTdmLTkwYjItNGE1OS1hZDg4LWEwZmQ5M2FiYWE4MiJ9" } } }, "presignedurlresponse": { "title": "presignedurlresponse", "type": "object", "properties": { "download_url": { "type": "string", "description": "The pre-signed URL for downloading the report file.", "example": "https://s3.amazonaws.com/reports/51f0097f.csv?AWSAccessKeyId=EXAMPLE" }, "file_name": { "type": "string", "description": "The filename of the report CSV.", "example": "report-51f0097f-90b2-4a59-ad88-a0fd93abaa82.csv" }, "file_size": { "type": "integer", "format": "int64", "description": "The size of the report file in bytes.", "example": 204800 }, "expires_in_seconds": { "type": "integer", "description": "The number of seconds until the pre-signed URL expires.", "example": 3600 }, "expires_at": { "type": "integer", "format": "int64", "description": "Unix timestamp (seconds) when the pre-signed URL expires.", "example": 1622555046 } } }, "404response": { "title": "Resource not found", "required": [ "message" ], "type": "object", "properties": { "message": { "type": "string" } }, "example": { "message": "Resource not found." } }, "schedule": { "title": "schedule", "type": "object", "description": "The time schedule of a scheduled report", "required": [ "timezone", "cron_expression", "type" ], "properties": { "timezone": { "type": "string", "example": "UTC", "description": "The timezone of the report." }, "cron_expression": { "type": "string", "example": "0 0 * * * ? *", "description": "A string consisting of six or seven subexpressions that describe individual details of the schedule." }, "type": { "type": "string", "example": "cron" } } }, "scheduleddetailrequest": { "title": "scheduleddetailrequest", "type": "object", "description": "A scheduled detail report request", "required": [ "period" ], "properties": { "period": { "$ref": "#/components/schemas/ReportPeriod" }, "timezone": { "type": "string", "example": "Australia/Sydney", "description": "The standard timezone name" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "source": { "type": "string", "example": "+61555555555", "description": "Filter results by source address." }, "sources": { "description": "Filter results by multiple source addresses. This property overrides the `source` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "destination": { "type": "string", "example": "+61555555555", "description": "Filter results by destination address." }, "destinations": { "description": "Filter results by multiple destination addresses. This property overrides the `destination` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "addresses": { "description": "Filter messages where source OR destination matches one of the provided values. This parameter can only be set when `direction` is `all` and cannot be used in the same request as the `source`, `destination`, `sources`, or `destinations` parameters.", "type": "array", "items": { "type": "string" }, "example": [ "+61400000001", "+61400000002" ] }, "message_format": { "$ref": "#/components/schemas/format" }, "channels": { "$ref": "#/components/schemas/channels" }, "metadata_key": { "type": "string", "example": "broadcastId", "description": "Filter results for messages that include a metadata key." }, "metadata_value": { "type": "string", "example": "ABC", "description": "Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided." }, "accounts": { "type": "array", "items": { "type": "string" }, "example": [ "Account1", "Account2" ], "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts." }, "status": { "type": "array", "items": { "$ref": "#/components/schemas/MessageStatus" }, "description": "An array of message statuses." }, "opt_out": { "type": "boolean", "example": true, "description": "Filter the report to only include messages that triggered an opt-out" }, "delivery_options": { "type": "array", "items": { "$ref": "#/components/schemas/deliveryOptionsBody" }, "description": "A list of options to configure the delivery of the report." } } }, "scheduleddetailreport": { "title": "scheduleddetailreport", "type": "object", "required": [ "label", "schedule", "report" ], "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "report": { "$ref": "#/components/schemas/scheduleddetailrequest" }, "metadata": { "type": "array", "description": "Metadata for the message as a list of key/value pairs. Each key can be up to 100 characters long and each value can be up to 256 characters long.\n```\n[\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n]\n```", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } } }, "example": [ { "key": "myKey", "value": "myValue" }, { "key": "anotherKey", "value": "anotherValue" } ] } } }, "scheduledreportresponse": { "title": "scheduledreportresponse", "type": "object", "properties": { "scheduled_report_id": { "type": "string", "example": "51f0097f-90b2-4a59-ad88-a0fd93abaa82", "description": "The ID of the scheduled report." } } }, "updatescheduleddetailreport": { "title": "updatescheduleddetailreport", "type": "object", "required": [ "label", "schedule", "report" ], "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "report": { "$ref": "#/components/schemas/scheduleddetailrequest" } } }, "scheduleddetailreportresponse": { "title": "scheduleddetailreportresponse", "type": "object", "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "report": { "$ref": "#/components/schemas/scheduleddetailrequest" }, "scheduled_report_id": { "type": "string", "example": "43928f76-c381-4943-8619-f10460005898", "description": "The ID of the scheduled report." }, "message_type": { "$ref": "#/components/schemas/MessageDirection" }, "report_type": { "type": "string", "example": "detail" }, "metadata": { "type": "array", "description": "Metadata for the message as a list of key/value pairs. Each key can be up to 100 characters long and each value can be up to 256 characters long.\n```\n[\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n]\n```", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } } }, "example": [ { "key": "myKey", "value": "myValue" }, { "key": "anotherKey", "value": "anotherValue" } ] } } }, "scheduledsummaryrequest": { "title": "scheduledsummaryrequest", "type": "object", "description": "A scheduled summary report request", "required": [ "period", "timezone" ], "properties": { "period": { "$ref": "#/components/schemas/ReportPeriod" }, "timezone": { "type": "string", "example": "Australia/Sydney", "description": "The standard timezone name" }, "direction": { "$ref": "#/components/schemas/MessageDirection" }, "source": { "type": "string", "example": "+61555555555", "description": "Filter results by source address." }, "sources": { "description": "Filter results by multiple source addresses. This property overrides the `source` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "destination": { "type": "string", "example": "+61555555555", "description": "Filter results by destination address." }, "destinations": { "description": "Filter results by multiple destination addresses. This property overrides the `destination` parameter.", "type": "array", "items": { "type": "string" }, "example": [ "+61555555555", "+614987654321" ] }, "addresses": { "description": "Filter messages where source OR destination matches one of the provided values. This parameter can only be set when `direction` is `all` and cannot be used in the same request as the `source`, `destination`, `sources`, or `destinations` parameters.", "type": "array", "items": { "type": "string" }, "example": [ "+61400000001", "+61400000002" ] }, "channels": { "$ref": "#/components/schemas/channels" }, "metadata_key": { "type": "string", "example": "broadcastId", "description": "Filter results for messages that include a metadata key." }, "metadata_value": { "type": "string", "example": "ABC", "description": "Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided." }, "accounts": { "type": "array", "items": { "type": "string" }, "example": [ "Account1", "Account2" ], "description": "Filter results by a specific account. By default results will be returned for the account associated with the authentication credentials and all sub-accounts." }, "status": { "type": "array", "items": { "$ref": "#/components/schemas/MessageStatus" }, "example": [ "DELIVERED", "ENROUTE" ], "description": "An array of message statuses." }, "opt_out": { "type": "boolean", "example": true, "description": "Filter the report to only include messages that triggered an opt-out." }, "group_by": { "type": "array", "items": { "$ref": "#/components/schemas/GroupByField" }, "example": [ "DAY", "WEEK" ], "description": "Group results by a list of values, from the enumerable table above." }, "account_activity": { "type": "string", "description": "Filter accounts included in the report by activity level.", "enum": [ "ALL", "COLD", "ACTIVE" ], "example": "ALL" }, "delivery_options": { "type": "array", "items": { "$ref": "#/components/schemas/deliveryOptionsBody" }, "description": "A list of options to configure the delivery of the report." } } }, "scheduledsummaryreport": { "title": "scheduledsummaryreport", "type": "object", "required": [ "label", "schedule", "report" ], "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "report": { "$ref": "#/components/schemas/scheduledsummaryrequest" }, "metadata": { "type": "array", "description": "Metadata for the message as a list of key/value pairs. Each key can be up to 100 characters long and each value can be up to 256 characters long.\n```\n[\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n]\n```", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } } }, "example": [ { "key": "myKey", "value": "myValue" }, { "key": "anotherKey", "value": "anotherValue" } ] } } }, "updatescheduledsummaryreport": { "title": "updatescheduledsummaryreport", "type": "object", "required": [ "label", "schedule", "report" ], "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "report": { "$ref": "#/components/schemas/scheduledsummaryrequest" } } }, "scheduledsummaryreportresposne": { "title": "scheduledsummaryreportresposne", "type": "object", "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "report": { "$ref": "#/components/schemas/scheduledsummaryrequest" }, "scheduled_report_id": { "type": "string", "example": "43928f76-c381-4943-8619-f10460005898", "description": "The ID of the scheduled report." }, "message_type": { "$ref": "#/components/schemas/MessageDirection" }, "report_type": { "type": "string", "example": "detail" }, "metadata": { "type": "array", "description": "Metadata for the message as a list of key/value pairs. Each key can be up to 100 characters long and each value can be up to 256 characters long.\n```\n[\n {\n \"key\": \"myKey\",\n \"value\": \"myValue\"\n },\n {\n \"key\": \"anotherKey\",\n \"value\": \"anotherValue\"\n }\n]\n```", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string" }, "value": { "type": "string" } } }, "example": [ { "key": "myKey", "value": "myValue" }, { "key": "anotherKey", "value": "anotherValue" } ] } } }, "scheduledreport": { "title": "scheduledreport", "type": "object", "properties": { "label": { "type": "string", "example": "Weekly Report", "description": "The label of the report schedule" }, "report": { "$ref": "#/components/schemas/scheduledsummaryrequest" }, "schedule": { "$ref": "#/components/schemas/schedule" }, "scheduled_report_id": { "type": "string", "example": "43928f76-c381-4943-8619-f10460005898", "description": "The ID of the scheduled report." }, "message_type": { "$ref": "#/components/schemas/MessageDirection" }, "report_type": { "type": "string", "example": "detail" }, "metadata": { "type": "object", "description": "Metadata for the scheduled report specified as a set of key value pairs, each key can be up to 100 characters long and each value can be up to 256 characters long.", "example": { "myKey": "myValue", "anotherKey": "anotherValue" } } } }, "chronosscheduleresponse": { "title": "chronosscheduleresponse", "type": "object", "properties": { "pagination": { "type": "object", "properties": { "page_token": { "type": "string", "example": "abc123" }, "page_size": { "type": "number", "example": 20, "description": "Number of results to return in a page for paginated result sets." } } }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/scheduledreport" } } } }, "SourceNumberType": { "title": "SourceNumberType", "enum": [ "INTERNATIONAL", "ALPHANUMERIC", "SHORTCODE" ], "type": "string", "description": "Type of source address specified, this can be INTERNATIONAL, ALPHANUMERIC or SHORTCODE", "example": "INTERNATIONAL" }, "Getmessagestatusresponse": { "title": "Getmessagestatusresponse", "type": "object", "properties": { "callback_url": { "type": "string", "description": "URL replies and delivery reports to this message will be pushed to", "example": "https://my.url.com" }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the message", "example": "Hello world!" }, "destination_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Destination number of the message", "example": "+61491570156" }, "delivery_report": { "type": "boolean", "description": "Request a delivery report for this message", "example": false }, "format": { "$ref": "#/components/schemas/Format" }, "message_expiry_timestamp": { "type": "string", "description": "Date time after which the message expires and will not be sent", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "metadata": { "type": "object", "description": "Metadata for the message specified as a set of key value pairs, each key can be up to 100 characters long and each value can be up to 256 characters long\n```\n{\n \"myKey\": \"myValue\",\n \"anotherKey\": \"anotherValue\"\n}\n```", "example": { "myKey": "myValue", "anotherKey": "anotherValue" } }, "scheduled": { "type": "string", "description": "Scheduled delivery date time of the message", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "source_number": { "type": "string", "example": "+61491570156" }, "source_number_type": { "$ref": "#/components/schemas/SourceNumberType" }, "message_id": { "type": "string", "description": "Unique ID of this message", "format": "uuid" }, "status": { "$ref": "#/components/schemas/Status" } } }, "Cancelscheduledmessagerequest": { "title": "Cancelscheduledmessagerequest", "required": [ "status" ], "type": "object", "properties": { "status": { "type": "string", "example": "cancelled", "description": "Must be set to ```cancelled```." } }, "example": { "status": "cancelled" } }, "Message": { "title": "Message", "required": [ "content", "destination_number" ], "type": "object", "properties": { "callback_url": { "type": "string", "description": "URL replies and delivery reports to this message will be pushed to.\nMust use the `http` or `https` scheme. Hostnames must conform to RFC 1123\nDNS name syntax. Paths must not contain whitespace or control characters.\nInvalid URLs are rejected with HTTP 400.\n", "example": "https://my.url.com" }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the message", "example": "Hello world!" }, "destination_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Destination number of the message", "example": "+61491570156" }, "delivery_report": { "type": "boolean", "description": "Request a delivery report for this message", "example": false }, "format": { "$ref": "#/components/schemas/Format" }, "message_expiry_timestamp": { "type": "string", "description": "Date time after which the message expires and will not be sent", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "metadata": { "type": "object", "description": "Metadata for the message specified as a set of key value pairs, each key can be up to 100 characters long and each value can be up to 256 characters long\n```\n{\n \"myKey\": \"myValue\",\n \"anotherKey\": \"anotherValue\"\n}\n```", "example": { "myKey": "myValue", "anotherKey": "anotherValue" } }, "scheduled": { "type": "string", "description": "Scheduled delivery date time of the message", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "source_number": { "type": "string", "example": "+61491570156" }, "source_number_type": { "$ref": "#/components/schemas/SourceNumberType" }, "message_id": { "type": "string", "description": "Unique ID of this message", "format": "uuid" }, "status": { "$ref": "#/components/schemas/Status" }, "media": { "type": "array", "items": { "type": "string" }, "description": "The media is used to specify a list of URLs of the media file(s) that you are trying to send. Supported file formats include png, jpeg and gif. format parameter must be set to MMS for this to work.", "example": [ "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg" ] }, "subject": { "type": "string", "description": "The subject field is used to denote subject of the MMS message and has a maximum size of 64 characters long", "example": "New Products" } } }, "Sendmessagesrequest": { "title": "Sendmessagesrequest", "required": [ "messages" ], "type": "object", "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Message" }, "description": "List of messages." } }, "example": { "messages": [ { "callback_url": "https://my.callback.url.com", "content": "My first message", "destination_number": "+61491570156", "delivery_report": true, "format": "SMS", "message_expiry_timestamp": "2016-11-03T11:49:02.807Z", "metadata": { "key1": "value1", "key2": "value2" }, "scheduled": "2016-11-03T11:49:02.807Z", "source_number": "+61491570157", "source_number_type": "INTERNATIONAL" }, { "callback_url": "https://my.callback.url.com", "content": "My second message", "destination_number": "+61491570158", "delivery_report": true, "format": "MMS", "subject": "This is an MMS message", "media": [ "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg" ], "message_expiry_timestamp": "2016-11-03T11:49:02.807Z", "metadata": { "key1": "value1", "key2": "value2" }, "scheduled": "2016-11-03T11:49:02.807Z", "source_number": "+61491570159", "source_number_type": "INTERNATIONAL" } ] } }, "Sendmessagesresponse": { "title": "Sendmessagesresponse", "type": "object", "properties": { "messages": { "maxItems": 100, "type": "array", "items": { "$ref": "#/components/schemas/Message" }, "description": "List of messages." } } }, "RequestAlphaTag": { "title": "RequestAlphaTag", "type": "object", "required": [ "sender_address", "sender_address_type", "usage_type", "destination_countries", "reason" ], "properties": { "sender_address": { "type": "string", "description": "The Sender Address to be requested" }, "sender_address_type": { "type": "string", "enum": [ "ALPHANUMERIC" ] }, "usage_type": { "type": "string", "enum": [ "ALPHANUMERIC" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes", "items": { "type": "string" } }, "reason": { "type": "string" }, "label": { "type": "string" } } }, "RequestVerificationCode": { "title": "RequestVerificationCode", "type": "object", "required": [ "sender_address", "sender_address_type", "usage_type", "destination_countries", "reason" ], "properties": { "sender_address": { "type": "string", "description": "The Own Number to be verified" }, "sender_address_type": { "type": "string", "enum": [ "INTERNATIONAL" ] }, "usage_type": { "type": "string", "enum": [ "OWN_NUMBER" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes", "items": { "type": "string" } }, "reason": { "type": "string" }, "label": { "type": "string" } } }, "AlphaTagRequestItem": { "title": "AlphaTagRequestItem", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Primary ID of the record", "example": "6f79a12e-14f1-4776-adc0-5c5e48a999b7" }, "sender_address": { "type": "string", "description": "The Alpha tag to be requested", "example": "EXAMPLE" }, "sender_address_type": { "type": "string", "description": "The Sender Address Type", "enum": [ "ALPHANUMERIC" ] }, "usage_type": { "type": "string", "description": "The Sender Address Usage Type", "enum": [ "ALPHANUMERIC" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes this sender address applies to", "items": { "type": "string" }, "example": [ "AU" ] }, "reason": { "type": "string", "example": "This is my reason" }, "label": { "type": "string", "example": "label" }, "status": { "type": "string", "enum": [ "OPEN", "PENDING", "REJECTED", "APPROVED" ] }, "account_id": { "type": "string", "example": "XYZ_ExampleAccount" }, "created_date": { "type": "string", "format": "date-time" }, "last_modified_date": { "type": "string", "format": "date-time" } } }, "VerificationCodeRequestItem": { "title": "VerificationCodeRequestItem", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Primary ID of the record", "example": "6f79a12e-14f1-4776-adc0-5c5e48a999b8" }, "sender_address": { "type": "string", "description": "The Own Number to be requested", "example": "+61401234567" }, "sender_address_type": { "type": "string", "description": "The Sender Address Type", "enum": [ "INTERNATIONAL" ] }, "usage_type": { "type": "string", "description": "The Sender Address Usage Type", "enum": [ "OWN_NUMBER" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes this sender address applies to", "items": { "type": "string" }, "example": [ "AU" ] }, "reason": { "type": "string", "example": "my personal number" }, "label": { "type": "string", "example": "label" }, "status": { "type": "string", "enum": [ "PENDING", "REJECTED", "APPROVED" ] }, "account_id": { "type": "string", "example": "XYZ_ExampleAccount" }, "created_date": { "type": "string", "format": "date-time" }, "last_modified_date": { "type": "string", "format": "date-time" } } }, "PostVerificationCode": { "type": "object", "title": "PostVerificationCode", "required": [ "verification_code" ], "properties": { "verification_code": { "type": "string", "description": "Verify Sender Address Request", "example": "123456" } } }, "ReVerifySenderAddressRequestItem": { "title": "ReVerifySenderAddressRequestItem", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Primary ID of the record", "example": "6f79a12e-14f1-4776-adc0-5c5e48a999b7" }, "sender_address": { "type": "string", "description": "The Sender Address to be requested", "example": "+61450999999" }, "sender_address_type": { "type": "string", "description": "The Sender Address Type", "enum": [ "INTERNATIONAL" ] }, "usage_type": { "type": "string", "description": "The Sender Address Usage Type", "enum": [ "OWN_NUMBER" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes this sender address applies to", "items": { "type": "string" }, "example": [ "AU", "NZ", "US" ] }, "reason": { "type": "string", "example": "my company is example.com" }, "label": { "type": "string", "example": "Example Address" }, "status": { "type": "string", "enum": [ "PENDING" ] }, "account_id": { "type": "string", "example": "XYZ_ExampleAccount" }, "created_date": { "type": "string", "format": "date-time" }, "last_modified_date": { "type": "string", "format": "date-time" } } }, "GetAllApprovedSenderAddresses": { "title": "GetAllApprovedSenderAddresses", "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Approved sender address UUID (use for get, update, re-verify, and delete)", "example": "7927d9eb-4e74-4021-836e-6cae071f84e7" }, "sender_address": { "type": "string", "description": "The sender address value (alpha tag or phone number as a string)", "example": "EXAMPLE1" }, "sender_address_type": { "type": "string", "description": "The Sender Address Type", "enum": [ "ALPHANUMERIC", "INTERNATIONAL", "SHORT_CODE" ] }, "usage_type": { "type": "string", "description": "The Sender Address Usage Type", "enum": [ "ALPHANUMERIC", "OWN_NUMBER", "DEDICATED", "HOSTED_NUMBER" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes this sender address applies to", "items": { "type": "string" } }, "reason": { "type": "string" }, "label": { "type": "string" }, "account_id": { "type": "string", "description": "Account that owns this sender address", "example": "my_account" }, "created_date": { "type": "string", "format": "date-time" }, "last_modified_date": { "type": "string", "format": "date-time" }, "expiry": { "type": "string", "format": "date-time", "description": "The Sender Address expiration time (apply for sender_address_type = OWN_NUMBER)\n" }, "display_status": { "type": "string", "description": "The Sender Address status (apply for sender_address_type = OWN_NUMBER)\n", "enum": [ "APPROVED", "EXPIRING", "EXPIRED" ] } } } }, "pagination": { "type": "object", "properties": { "page_size": { "type": "number" }, "next_token": { "type": "string", "description": "The pagination token of the next set of results." } } } } }, "GetSenderAddress": { "title": "GetSenderAddress", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Approved sender address UUID (use for get, update, re-verify, and delete)", "example": "6f79a12e-14f1-4776-adc0-5c5e48a999b8" }, "sender_address": { "type": "string", "description": "The sender address value (alpha tag or phone number as a string)", "example": "+61401234567" }, "sender_address_type": { "type": "string", "description": "The Sender Address Type", "enum": [ "ALPHANUMERIC", "INTERNATIONAL", "SHORT_CODE" ] }, "usage_type": { "type": "string", "description": "The Sender Address Usage Type", "enum": [ "ALPHANUMERIC", "OWN_NUMBER", "DEDICATED", "HOSTED_NUMBER" ] }, "destination_countries": { "type": "array", "description": "list of 2-character ISO country codes this sender address applies to", "items": { "type": "string" }, "example": [ "AU" ] }, "reason": { "type": "string", "example": "my personal number" }, "label": { "type": "string", "example": "ABC" }, "account_id": { "type": "string", "example": "XYZ_ExampleAccount" }, "created_date": { "type": "string", "format": "date-time" }, "last_modified_date": { "type": "string", "format": "date-time" }, "expiry": { "type": "string", "format": "date-time", "description": "The Sender Address expiration time (apply for sender_address_type = OWN_NUMBER)" }, "display_status": { "type": "string", "enum": [ "APPROVED", "EXPIRED", "EXPIRING" ] } } }, "PatchLabelMyOwnNumber": { "type": "object", "title": "PatchLabelMyOwnNumber", "required": [ "label" ], "properties": { "label": { "type": "string", "maxLength": 100, "description": "Label need to be updated", "example": "My Number" } } }, "VendorAccountId": { "title": "VendorAccountId", "type": "object", "properties": { "vendor_id": { "type": "string", "example": "SinchEU" }, "account_id": { "type": "string", "description": "The account used to submit the original message.", "example": "MyAccount001" } } }, "DeliveryReport": { "title": "DeliveryReport", "type": "object", "properties": { "callback_url": { "type": "string", "description": "The URL specified as the callback URL in the original submit message request", "example": "https://my.url.com" }, "date_received": { "type": "string", "description": "The date and time at which this delivery report was generated in UTC.", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "delay": { "type": "integer", "deprecated": true, "description": "Deprecated, no longer in use", "format": "int32", "example": 0 }, "billing_units": { "type": "integer", "description": "The billing units of this report", "format": "int32", "example": 1 }, "delivery_report_id": { "type": "string", "description": "Unique ID for this delivery report", "format": "uuid" }, "message_id": { "type": "string", "description": "Unique ID of the original message", "format": "uuid" }, "metadata": { "type": "object", "description": "Any metadata that was included in the original submit message request" }, "original_text": { "type": "string", "description": "Text of the original message.", "example": "Hello back" }, "source_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this delivery report was received", "example": "+61491570156" }, "status": { "$ref": "#/components/schemas/Status" }, "submitted_date": { "type": "string", "description": "The date and time when the message status changed in UTC. For a delivered DR this may indicate the time at which the message was received on the handset.", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "vendor_account_id": { "$ref": "#/components/schemas/VendorAccountId" } } }, "Checkdeliveryreportsresponse": { "title": "Checkdeliveryreportsresponse", "type": "object", "properties": { "delivery_reports": { "maxItems": 100, "minItems": 0, "type": "array", "items": { "$ref": "#/components/schemas/DeliveryReport" }, "description": "The oldest 100 unconfirmed delivery reports" } }, "example": { "delivery_reports": [ { "callback_url": "https://my.callback.url.com", "delivery_report_id": "01e1fa0a-6e27-4945-9cdb-18644b4de043", "source_number": "+61491570157", "date_received": "2017-05-20T06:30:37.642Z", "status": "enroute", "delay": 0, "billing_units": 1, "submitted_date": "2017-05-20T06:30:37.639Z", "original_text": "My first message!", "message_id": "d781dcab-d9d8-4fb2-9e03-872f07ae94ba", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "metadata": { "key1": "value1", "key2": "value2" } }, { "callback_url": "https://my.callback.url.com", "delivery_report_id": "0edf9022-7ccc-43e6-acab-480e93e98c1b", "source_number": "+61491570158", "date_received": "2017-05-21T01:46:42.579Z", "status": "submitted", "delay": 0, "billing_units": 1, "submitted_date": "2017-05-21T01:46:42.574Z", "original_text": "My second message!", "message_id": "fbb3b3f5-b702-4d8b-ab44-65b2ee39a281", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "metadata": { "key1": "value1", "key2": "value2" } } ] } }, "Confirmdeliveryreportsasreceivedrequest": { "title": "Confirmeliveryreportsasreceivedrequest", "required": [ "delivery_report_ids" ], "type": "object", "properties": { "delivery_report_ids": { "maxItems": 100, "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "Array of unique IDs for the delivery report that this notification represents" } }, "example": { "delivery_report_ids": [ "011dcead-6988-4ad6-a1c7-6b6c68ea628d", "3487b3fa-6586-4979-a233-2d1b095c7718", "ba28e94b-c83d-4759-98e7-ff9c7edb87a1" ] } }, "Reply": { "title": "Reply", "type": "object", "properties": { "callback_url": { "type": "string", "description": "The URL specified as the callback URL in the original submit message request", "example": "https://my.url.com" }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the reply", "example": "Hello back" }, "date_received": { "type": "string", "description": "Date time when the reply was received", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "destination_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this reply was sent to", "example": "+61491570156" }, "message_id": { "type": "string", "description": "Unique ID of the original message", "format": "uuid" }, "metadata": { "type": "object", "description": "Any metadata that was included in the original submit message request" }, "reply_id": { "type": "string", "description": "Unique ID of this reply", "format": "uuid" }, "source_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this reply was received from", "example": "+61491570156" }, "vendor_account_id": { "$ref": "#/components/schemas/VendorAccountId" } } }, "Checkrepliesresponse": { "title": "Checkrepliesresponse", "type": "object", "properties": { "replies": { "maxItems": 100, "minItems": 0, "type": "array", "items": { "$ref": "#/components/schemas/Reply" }, "description": "The oldest 100 unconfirmed replies" } }, "example": { "replies": [ { "metadata": { "key1": "value1", "key2": "value2" }, "message_id": "877c19ef-fa2e-4cec-827a-e1df9b5509f7", "reply_id": "a175e797-2b54-468b-9850-41a3eab32f74", "date_received": "2016-12-07T08:43:00.850Z", "callback_url": "https://my.callback.url.com", "destination_number": "+61491570156", "source_number": "+61491570157", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "content": "My first reply!" }, { "metadata": { "key1": "value1", "key2": "value2" }, "message_id": "8f2f5927-2e16-4f1c-bd43-47dbe2a77ae4", "reply_id": "3d8d53d8-01d3-45dd-8cfa-4dfc81600f7f", "date_received": "2016-12-07T08:43:00.850Z", "callback_url": "https://my.callback.url.com", "destination_number": "+61491570157", "source_number": "+61491570158", "vendor_account_id": { "vendor_id": "SinchEU", "account_id": "MyAccount" }, "content": "My second reply!" } ] } }, "Confirmrepliesasreceivedrequest": { "title": "Confirmrepliesasreceivedrequest", "required": [ "reply_ids" ], "type": "object", "properties": { "reply_ids": { "maxItems": 100, "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "The UUID of the *reply* to be confirmed (note: not the UUID of the message it is in response to)" } }, "example": { "reply_ids": [ "011dcead-6988-4ad6-a1c7-6b6c68ea628d", "3487b3fa-6586-4979-a233-2d1b095c7718", "ba28e94b-c83d-4759-98e7-ff9c7edb87a1" ] } }, "PaginationNumberAuth": { "title": "Pagination", "type": "object", "properties": { "page": { "type": "string", "description": "The pagination token of the next set of results.", "example": "0" }, "next_uri": { "type": "string", "description": "The uri pointing to the next set of results.", "example": "/v1/number_authorisation/mt/blacklist?token=0" } } }, "Getnumberauthorisationblacklistresponse": { "title": "Getnumberauthorisationblacklistresponse", "type": "object", "properties": { "uri": { "type": "string", "description": "URL of the current API call, used to show the current pagination token for calls subsequent to the first one in the case of paginated data.", "example": "/v1/number_authorisation/mt/blacklist\"" }, "numbers": { "type": "array", "description": "List of numbers belonging to the blacklist.", "items": { "type": "string" }, "example": [ "+61491570156", "+61491570157" ] }, "pagination": { "$ref": "#/components/schemas/PaginationNumberAuth" } } }, "Addoneormorenumberstoyourblacklistrequest": { "title": "Addoneormorenumberstoyourblacklistrequest", "required": [ "numbers" ], "type": "object", "properties": { "numbers": { "type": "array", "items": { "type": "string" }, "description": "Array of numbers to be added to the blacklist. These should be specified in E.164 international format. For information on E.164, please refer to http://en.wikipedia.org/wiki/E.164." } }, "example": { "numbers": [ "61491570156", "61491570157" ] } }, "Addoneormorenumberstoyourblacklistresponse": { "title": "Addoneormorenumberstoyourblacklistresponse", "required": [ "uri", "numbers" ], "type": "object", "properties": { "uri": { "type": "string" }, "numbers": { "type": "array", "items": { "type": "string" }, "description": "List of phone numbers." } }, "example": { "uri": "/v1/number_authorisation/mt/blacklist", "numbers": [ "61491570156", "61491570157" ] } }, "Number": { "title": "Number", "required": [ "number", "authorised" ], "type": "object", "description": "Number authorisation result for a single phone number", "properties": { "number": { "type": "string", "description": "Phone number as a string", "example": "+61491570156" }, "authorised": { "type": "boolean", "description": "Whether the authenticated account is authorised to use this number" } }, "example": { "number": "+61491570156", "authorised": true } }, "Checkifoneorseveralnumbersarecurrentlyblacklistedresponse": { "title": "Checkifoneorseveralnumbersarecurrentlyblacklistedresponse", "required": [ "uri", "numbers" ], "type": "object", "properties": { "uri": { "type": "string" }, "numbers": { "type": "array", "items": { "$ref": "#/components/schemas/Number" }, "description": "List of phone numbers." } }, "example": { "uri": "/v1/number_authorisation/is_authorised/+61491570156,+61491570157", "numbers": [ { "number": "+61491570156", "authorised": true }, { "number": "+61491570157", "authorised": false } ] } }, "service_types": { "title": "service_types", "enum": [ "SMS", "TTS", "MMS" ], "type": "string", "example": "SMS" }, "Type": { "title": "Type", "type": "string", "description": "Dedicated number type", "enum": [ "MOBILE", "LANDLINE", "TEN_DLC", "TOLL_FREE", "SHORT_CODE", "HOSTED_TEN_DLC", "HOSTED_TOLL_FREE" ], "example": "MOBILE" }, "Types": { "title": "Types", "type": "array", "description": "One or more dedicated number types. Pass as a repeated query parameter (`types=MOBILE&types=LANDLINE`) or as a comma-separated list (`types=MOBILE,LANDLINE,TOLL_FREE`).\n", "items": { "$ref": "#/components/schemas/Type" }, "example": [ "MOBILE", "LANDLINE", "TOLL_FREE" ] }, "Classification": { "title": "Classification", "enum": [ "BRONZE", "SILVER", "GOLD" ], "type": "string", "example": "BRONZE" }, "Capability": { "title": "Capability", "enum": [ "SMS", "TTS", "MMS" ], "type": "string", "example": "SMS" }, "DedicatedNumber": { "title": "DedicatedNumber", "type": "object", "description": "A dedicated number available for purchase or already inventoried", "properties": { "id": { "type": "string", "format": "uuid", "description": "Unique identifier of the dedicated number", "example": "be3cb602-7c00-4c87-ae4b-b8defc04f179" }, "phone_number": { "type": "string", "description": "Phone number as a string (digits; may include a leading +)", "example": "614111111111" }, "country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code", "example": "AU" }, "type": { "$ref": "#/components/schemas/Type" }, "classification": { "$ref": "#/components/schemas/Classification" }, "available_after": { "type": "string", "format": "date-time", "description": "Earliest time this number can be assigned" }, "capabilities": { "type": "array", "items": { "$ref": "#/components/schemas/Capability" }, "description": "Capabilities supported by this number" } }, "example": { "id": "be3cb602-7c00-4c87-ae4b-b8defc04f179", "phone_number": "614111111111", "country": "AU", "type": "MOBILE", "classification": "SILVER", "available_after": "2019-06-21T04:04:31.707Z", "capabilities": [ "SMS", "MMS" ] } }, "TokenPagination": { "title": "TokenPagination", "type": "object", "description": "Cursor-style pagination used by Dedicated Numbers list endpoints. Pass `next_token` back as the `token` query parameter to fetch the next page.\n", "properties": { "page_size": { "type": "integer", "format": "int32", "description": "Number of results returned in this page", "example": 5 }, "next_token": { "type": "string", "format": "uuid", "description": "Token for the next page of results. Omit or null when there are no further pages. Pass this value as the `token` query parameter on the next request.\n", "example": "0428d673-0f75-4063-9493-e89d75f13438" } }, "example": { "page_size": 5, "next_token": "0428d673-0f75-4063-9493-e89d75f13438" } }, "NumbersListResponse": { "title": "NumbersListResponse", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DedicatedNumber" }, "description": "List of result items." }, "pagination": { "$ref": "#/components/schemas/TokenPagination" } }, "example": { "pagination": { "next_token": "0428d673-0f75-4063-9493-e89d75f13438", "page_size": 5 }, "data": [ { "id": "03cf54ad-a4a3-4cd1-afd5-e0ca2cf158a3", "phone_number": "61436489205", "country": "AU", "type": "MOBILE", "classification": "BRONZE", "available_after": "2019-08-06T23:56:15.633Z", "capabilities": [ "SMS" ] } ] } }, "Assignment": { "title": "Assignment", "type": "object", "properties": { "id": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "number_id": { "type": "string" }, "label": { "type": "string" } }, "example": { "metadata": { "key1": "value1" }, "label": "LabelTest0", "id": "be3cb602-7c00-4c87-ae4b-b8defc04f179", "number_id": "b9ee3fe8-2c20-47b1-96e9-c5d12d7ed985" } }, "Metadata": { "title": "Metadata", "type": "object", "additionalProperties": { "type": "string" }, "example": { "Key1": "value1", "Key2": "value2" } }, "createAssignmentrequest": { "title": "createAssignmentrequest", "required": [ "label", "metadata" ], "type": "object", "properties": { "label": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/Metadata" } }, "example": { "label": "ExampleLabel", "metadata": { "Key1": "value1", "Key2": "value2" } } }, "updateAssignmentrequest": { "title": "updateAssignmentrequest", "required": [ "label", "metadata" ], "type": "object", "properties": { "label": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/Metadata" } }, "example": { "label": "ExampleLabel", "metadata": { "Key1": "value1", "Key2": "value2" } } }, "sort_by": { "title": "sort_by", "enum": [ "ACCOUNT", "ACTION", "DESTINATION_ADDRESS", "DESTINATION_ADDRESS_COUNTRY", "FORMAT", "SOURCE_ADDRESS", "SOURCE_ADDRESS_COUNTRY", "TIMESTAMP" ], "type": "string", "description": "Field to sort results set by", "example": "ACCOUNT" }, "sort_direction": { "title": "sort_direction", "enum": [ "ASCENDING", "DESCENDING" ], "type": "string", "description": "Order to sort results by.", "example": "ASCENDING" }, "AssignedNumber": { "title": "AssignedNumber", "type": "object", "description": "An assigned dedicated number and its assignment metadata", "properties": { "assignment": { "$ref": "#/components/schemas/Assignment" }, "number": { "$ref": "#/components/schemas/DedicatedNumber" } } }, "AssignedNumberListResponse": { "title": "AssignedNumberListResponse", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssignedNumber" }, "description": "List of result items." }, "pagination": { "$ref": "#/components/schemas/TokenPagination" } }, "example": { "pagination": { "next_token": "0428d673-0f75-4063-9493-e89d75f13438", "page_size": 5 }, "data": [ { "assignment": { "metadata": { "key1": "value1" }, "label": "LabelTest0", "id": "be3cb602-7c00-4c87-ae4b-b8defc04f179", "number_id": "b9ee3fe8-2c20-47b1-96e9-c5d12d7ed985" }, "number": { "id": "03cf54ad-a4a3-4cd1-afd5-e0ca2cf158a3", "phone_number": "61436489205", "country": "AU", "type": "MOBILE", "classification": "BRONZE", "available_after": "2019-08-06T23:56:15.633Z", "capabilities": [ "SMS" ] } } ] } }, "ShortUrl": { "title": "ShortUrl", "type": "object", "properties": { "click_count": { "type": "number", "example": 3 }, "view_count": { "type": "number", "example": 2 }, "message_id": { "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "long_url": { "type": "string", "example": "https://developers.sinch.com" }, "short_url": { "type": "string", "example": "https://nxt.to/abc1234" }, "destination_number": { "type": "string", "example": "+61491570157" } } }, "Pagination": { "title": "Pagination", "type": "object", "properties": { "page": { "type": "number", "description": "The current page of results", "example": 3 }, "page_size": { "type": "number", "description": "The amount of results returned per page", "example": 50 }, "total_count": { "type": "number", "description": "The total number of results in the results set", "example": 80 }, "page_count": { "type": "number", "description": "The total number of pages in the results set", "example": 5 }, "next_uri": { "type": "string", "description": "Link to the next page of results", "example": "example.url" }, "previous_uri": { "type": "string", "description": "Link to the previous page of results", "example": "example.url" } } }, "LogSummaryResult": { "title": "LogSummaryResult", "type": "object", "properties": { "total_clicks": { "type": "number", "example": 3 }, "unique_clicks": { "type": "number", "example": 1 }, "total_views": { "type": "number", "example": 2 }, "unique_views": { "type": "number", "example": 1 }, "short_urls_generated": { "type": "number", "example": 1 }, "short_urls": { "type": "array", "items": { "$ref": "#/components/schemas/ShortUrl" }, "description": "List of short URLs." }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "example": { "total_clicks": 3, "unique_clicks": 1, "total_views": 2, "unique_views": 1, "short_urls_generated": 1, "short_urls": [ { "click_count": 3, "view_count": 2, "message_id": "00000000-0000-0000-0000-000000000000", "long_url": "https://developers.sinch.com", "short_url": "https://nxt.to/abc1234", "destination_number": "+61491570157" } ], "pagination": { "page": 1, "page_size": 100, "page_count": 3 } } }, "Click": { "title": "Click", "type": "object", "properties": { "dt": { "type": "string", "example": "2018-09-18T01:22:17.071493" }, "user_agent": { "type": "string", "example": "Mozilla/5.0 (Windows NT..." }, "ip": { "type": "string", "example": "127.0.0.1" } } }, "View": { "title": "View", "type": "object", "properties": { "dt": { "type": "string", "example": "2018-09-18T01:22:17.071493" }, "user_agent": { "type": "string", "example": "Mozilla/5.0 (Windows NT..." }, "ip": { "type": "string", "example": "127.0.0.1" } } }, "LogsDetailResult": { "title": "LogsDetailResult", "type": "object", "properties": { "message_id": { "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "long_url": { "type": "string", "example": "https://developers.sinch.com" }, "short_url": { "type": "string", "example": "https://nxt.to/abc1234" }, "destination_number": { "type": "string", "example": "+61491570157" }, "click_count": { "type": "number", "example": 3 }, "view_count": { "type": "number", "example": 2 }, "clicks": { "type": "array", "items": { "$ref": "#/components/schemas/Click" }, "description": "List of click events." }, "views": { "type": "array", "items": { "$ref": "#/components/schemas/View" }, "description": "List of view events." }, "pagination": { "$ref": "#/components/schemas/Pagination" } }, "example": { "message_id": "00000000-0000-0000-0000-000000000000", "long_url": "https://developers.sinch.com", "short_url": "https://nxt.to/abc1234", "destination_number": "+61491570157", "click_count": 3, "view_count": 2, "clicks": [ { "dt": "2018-09-18T01:22:17.071493", "user_agent": "Mozilla/5.0 (Windows NT...", "ip": "127.0.0.1" } ], "views": [ { "dt": "2018-09-18T01:22:17.071493", "user_agent": "Mozilla/5.0 (Windows NT...", "ip": "127.0.0.1" } ], "pagination": { "page": 1, "page_size": 100, "page_count": 3 } } }, "CreateWebhookresponse": { "title": "CreateWebhookresponse", "description": "Webhook response object. No fields are strictly required in the schema;\nhowever, id, url, method, and retries are consistently populated.\n", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Unique identifier for the webhook. Always present." }, "url": { "type": "string", "description": "HTTP(S) URL for the webhook endpoint. Always present." }, "method": { "type": "string", "description": "HTTP method used when invoking the webhook. Always present." }, "encoding": { "type": "string", "description": "Content encoding. Usually present; can be null if missing/unknown." }, "headers": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Custom headers configured for the webhook. May be empty." }, "events": { "type": "array", "items": { "type": "string" }, "description": "Webhook event types subscribed to. May be empty." }, "template": { "type": "string", "description": "Velocity template for the webhook request body. Only present if set." }, "read_timeout": { "type": "integer", "description": "The read timeout in milliseconds. Only present if set." }, "retries": { "type": "integer", "description": "The number of retry attempts. Always present (defaults to 0)." }, "retry_delay": { "type": "integer", "description": "The delay between retries in seconds. Only present when retries are configured." } }, "example": { "id": "76fa7010-8c1f-4a24-917a-4d62a54e744d", "url": "http://webhook.com", "method": "POST", "encoding": "JSON", "headers": {}, "events": [ "ENROUTE_DR", "DELIVERED_DR" ], "template": "{\"id\":\"$mtId\",\"status\":\"$statusCode\"}", "read_timeout": 5000, "retries": 3, "retry_delay": 30 } }, "RetrieveWebhookresponse": { "title": "RetrieveWebhookresponse", "type": "object", "properties": { "page": { "type": "integer", "format": "int32", "description": "The current page number." }, "pageSize": { "type": "integer", "format": "int32", "description": "The number of webhooks returned per page." }, "pageData": { "type": "array", "description": "The list of webhooks created for the connected account.", "items": { "$ref": "#/components/schemas/CreateWebhookresponse" } } }, "example": { "page": 0, "pageSize": 100, "pageData": [ { "id": "76fa7010-8c1f-4a24-917a-4d62a54e744d", "url": "http://webhook.com", "method": "POST", "encoding": "JSON", "headers": {}, "events": [ "ENROUTE_DR", "DELIVERED_DR" ], "template": "{\"id\":\"$mtId\",\"status\":\"$statusCode\"}", "read_timeout": 5000, "retries": 3, "retry_delay": 30 } ] } }, "UpdateWebhook400response": { "title": "UpdateWebhook400response", "required": [ "message" ], "type": "object", "properties": { "message": { "type": "string" }, "details": { "type": "array", "items": { "type": "string" }, "description": "Additional error detail messages." } }, "example": { "message": "Bad Request", "details": [ "/url: Not a valid http url" ] } }, "CreateWebhookrequest": { "title": "CreateWebhookrequest", "required": [ "url", "method", "encoding", "events" ], "type": "object", "properties": { "url": { "type": "string", "maxLength": 1000, "description": "HTTP(S) URL for the webhook endpoint. Must use the `http` or `https` scheme.\nHostnames must conform to RFC 1123 DNS name syntax.\nPaths must not contain whitespace or control characters.\nInvalid URLs are rejected with HTTP 400.\n" }, "method": { "type": "string", "enum": [ "GET", "POST", "PATCH", "PUT", "DELETE" ], "description": "HTTP method used when invoking the webhook." }, "encoding": { "type": "string", "enum": [ "JSON", "FORM_ENCODED", "XML" ], "description": "Content encoding for the webhook request body." }, "events": { "type": "array", "items": { "type": "string" }, "minItems": 1, "description": "Non-empty set of webhook event types to subscribe to." }, "headers": { "type": "object", "additionalProperties": { "type": "string", "maxLength": 1000 }, "description": "Optional map of custom headers. Content-Type header is not allowed.\nKey max length is 200 characters, value max length is 1000 characters.\n" }, "template": { "type": "string", "description": "Optional Velocity template for the webhook request body." }, "read_timeout": { "type": "integer", "minimum": 1, "maximum": 60000, "description": "The read timeout for the webhook call in milliseconds (1-60000)." }, "retries": { "type": "integer", "minimum": 0, "maximum": 5, "description": "The number of times to retry a failed webhook call (0-5)." }, "retry_delay": { "type": "integer", "minimum": 5, "maximum": 60, "description": "The delay between retries in seconds (5-60)." } }, "example": { "url": "http://webhook.com", "method": "POST", "encoding": "JSON", "headers": {}, "events": [ "ENROUTE_DR", "DELIVERED_DR" ], "template": "{\"id\":\"$mtId\",\"status\":\"$statusCode\"}", "read_timeout": 5000, "retries": 3, "retry_delay": 30 } }, "UpdateWebhookrequest": { "title": "UpdateWebhookrequest", "description": "All fields are optional, but at least one must be provided.\nEmpty body (all fields null) is rejected.\nNote: read_timeout, retries, and retry_delay are not supported on update (create-only).\n", "type": "object", "properties": { "url": { "type": "string", "maxLength": 1000, "description": "HTTP(S) URL for the webhook endpoint. Must use the `http` or `https` scheme.\nHostnames must conform to RFC 1123 DNS name syntax.\nPaths must not contain whitespace or control characters.\nInvalid URLs are rejected with HTTP 400.\n" }, "method": { "type": "string", "enum": [ "GET", "POST", "PATCH", "PUT", "DELETE" ], "description": "HTTP method used when invoking the webhook." }, "encoding": { "type": "string", "enum": [ "JSON", "FORM_ENCODED", "XML" ], "description": "Content encoding for the webhook request body." }, "headers": { "type": "object", "additionalProperties": { "type": "string", "maxLength": 1000 }, "description": "Optional map of custom headers. Content-Type header is not allowed.\nKey max length is 200 characters, value max length is 1000 characters.\n" }, "template": { "type": "string", "description": "Velocity template for the webhook request body." }, "events": { "type": "array", "items": { "type": "string" }, "minItems": 1, "description": "Webhook event types to subscribe to.\nIf provided, must be non-empty (events: [] is rejected).\n" } }, "example": { "url": "http://webhook.com", "method": "POST", "encoding": "JSON", "headers": {}, "events": [ "ENROUTE_DR", "DELIVERED_DR" ], "template": "{\"id\":\"$mtId\",\"status\":\"$statusCode\"}" } }, "Getsignaturekeylistresponse": { "title": "Getsignaturekeylistresponse", "type": "object", "properties": { "key_id": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" }, "cipher": { "type": "string", "example": "RSA" }, "digest": { "type": "string", "example": "SHA224" }, "created": { "type": "string", "example": "2018-01-18T10:16:12.364Z" }, "enabled": { "type": "boolean", "example": false } }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": true } }, "Enablesignaturekey400response": { "title": "Enablesignaturekey400response", "required": [ "message", "details" ], "type": "object", "properties": { "message": { "type": "string" }, "details": { "type": "array", "items": { "type": "string" }, "description": "Additional error detail messages." } }, "example": { "message": "Bad Request", "details": [ "/key_id: Key id cannot be null" ] } }, "Disablethecurrentenabledsignaturekey.403response": { "title": "Disablethecurrentenabledsignaturekey.403response", "required": [ "message" ], "type": "object", "properties": { "message": { "type": "string" } }, "example": { "message": "This feature has not been enabled in your account." } }, "Createsignaturekeyrequest": { "title": "Createsignaturekeyrequest", "required": [ "digest", "cipher" ], "type": "object", "properties": { "digest": { "type": "string" }, "cipher": { "type": "string" } }, "example": { "digest": "SHA224", "cipher": "RSA" } }, "Createsignaturekeyresponse": { "title": "Createsignaturekeyresponse", "required": [ "key_id", "public_key", "cipher", "digest", "created", "enabled" ], "type": "object", "properties": { "key_id": { "type": "string" }, "public_key": { "type": "string" }, "cipher": { "type": "string" }, "digest": { "type": "string" }, "created": { "type": "string" }, "enabled": { "type": "boolean" } }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "public_key": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCTIxtRyT5CuOD74r7UCT+AKzWNxvaAP9myjAqR7+vBnJKEvoPnmbKTnm6uLlxutnMbjKrnCCWnQ9vtBVnnd+ElhwLDPADfMcJoOqwi7mTcxucckeEbBsfsgYRfdacxgSZL8hVD1hLViQr3xwjEIkJcx1w3x8npvwMuTY0uW8+PjwIDAQAB", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": false } }, "Getsignaturekeydetailresponse": { "title": "Getsignaturekeydetailresponse", "type": "object", "properties": { "key_id": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" }, "cipher": { "type": "string", "example": "RSA" }, "digest": { "type": "string", "example": "SHA224" }, "created": { "type": "string", "example": "2018-01-18T10:16:12.364Z" }, "enabled": { "type": "boolean", "example": false } }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": false } }, "Getenabledsignaturekeyresponse": { "title": "Getenabledsignaturekeyresponse", "type": "object", "properties": { "key_id": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" }, "cipher": { "type": "string", "example": "RSA" }, "digest": { "type": "string", "example": "SHA224" }, "created": { "type": "string", "example": "2018-01-18T10:16:12.364Z" }, "enabled": { "type": "boolean", "example": true } }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": true } }, "Enablesignaturekeyrequest": { "title": "Enablesignaturekeyrequest", "required": [ "key_id" ], "type": "object", "properties": { "key_id": { "type": "string" } }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31" } }, "Enablesignaturekeyresponse": { "title": "Enablesignaturekeyresponse", "type": "object", "properties": { "key_id": { "type": "string", "example": "7ca628a8-08b0-4e42-aeb8-960b37049c31" }, "cipher": { "type": "string", "example": "RSA" }, "digest": { "type": "string", "example": "SHA224" }, "created": { "type": "string", "example": "2018-01-18T10:16:12.364Z" }, "enabled": { "type": "boolean", "example": true } }, "example": { "key_id": "7ca628a8-08b0-4e42-aeb8-960b37049c31", "cipher": "RSA", "digest": "SHA224", "created": "2018-01-18T10:16:12.364Z", "enabled": true } }, "GetContactsRequest": { "type": "object", "properties": { "nextPageToken": { "type": "string" }, "prevPageToken": { "type": "string" }, "pageSize": { "maximum": 1000, "type": "integer", "format": "int32" }, "listIds": { "type": "array", "items": { "type": "string", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, "contactIds": { "type": "array", "items": { "type": "string", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, "channelIds": { "type": "array", "items": { "type": "string", "example": "+15553456783" } }, "channelTypes": { "type": "array", "items": { "type": "string", "enum": [ "SMS", "WHATSAPP", "GBM", "INSTAGRAM", "FACEBOOK", "EMAIL" ] } }, "channelSubscriptionState": { "type": "string", "enum": [ "SUBSCRIBED", "UNSUBSCRIBED" ] } }, "description": "Get contacts page filter payload" }, "ContactCustomFieldData": { "required": [ "id", "mergeTag", "type", "value" ], "type": "object", "properties": { "id": { "type": "string", "description": "Custom Field id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" }, "mergeTag": { "type": "string", "description": "Custom field merge tag", "example": "contact_name" }, "value": { "type": "string", "description": "Custom field value", "example": "John" }, "type": { "type": "string", "description": "Custom field type", "example": "DATE", "enum": [ "DATE", "NUMBER", "PHONE", "TEXT", "URL", "ZIP_CODE", "NAME", "EMAIL" ] } }, "description": "Custom field data" }, "ContactChannelData": { "required": [ "channelId", "type" ], "type": "object", "properties": { "channelId": { "type": "string", "description": "Contact channel id (in case phone number - in E164 international format)", "example": "+15553456783" }, "type": { "type": "string", "description": "Contact channel type", "example": "SMS", "enum": [ "SMS", "WHATSAPP", "GBM", "INSTAGRAM", "FACEBOOK", "EMAIL" ] }, "subscriptionState": { "type": "string", "description": "Subscription state", "example": "UNSUBSCRIBED", "enum": [ "SUBSCRIBED", "UNSUBSCRIBED" ] } }, "description": "Contact channel data" }, "ContactListData": { "required": [ "id", "name" ], "type": "object", "properties": { "id": { "type": "string", "description": "List id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" }, "name": { "type": "string", "description": "List name", "example": "My list" } }, "description": "Contact list data" }, "ContactData": { "required": [ "accountId", "alias", "channels", "country", "createdDate", "customFields", "firstName", "fullName", "id", "lastModifiedDate", "lastName", "lists", "location", "note", "state", "vendorId" ], "type": "object", "properties": { "id": { "type": "string", "description": "Contact id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" }, "accountId": { "type": "string", "description": "Account id" }, "vendorId": { "type": "string", "description": "Vendor id" }, "firstName": { "type": "string", "description": "Contact first name", "example": "Adam" }, "lastName": { "type": "string", "description": "Contact last name", "example": "Smith" }, "fullName": { "type": "string", "description": "Contact full name", "example": "Adam Smith" }, "alias": { "type": "string", "description": "Contact alias", "example": "VIP contact" }, "dateOfBirth": { "type": "string", "description": "Date of birth", "format": "date", "example": "2022-08-18" }, "country": { "type": "string", "description": "Country", "example": "US" }, "state": { "type": "string", "description": "State", "example": "CA" }, "location": { "type": "string", "description": "Location", "example": "Sunset Blvd" }, "note": { "type": "string", "description": "Note", "example": "Note" }, "createdDate": { "type": "string", "description": "Create date", "format": "date-time", "example": "2022-08-18T09:15:03.112Z" }, "lastModifiedDate": { "type": "string", "description": "Last modified date", "format": "date-time", "example": "2022-08-18T09:15:03.112Z" }, "customFields": { "type": "array", "description": "List of custom fields", "items": { "$ref": "#/components/schemas/ContactCustomFieldData" } }, "channels": { "type": "array", "description": "Contact channels", "items": { "$ref": "#/components/schemas/ContactChannelData" } }, "lists": { "type": "array", "description": "Contact lists", "items": { "$ref": "#/components/schemas/ContactListData" } } }, "description": "Contact data" }, "PageTokenDtoContactData": { "required": [ "content", "totalElements" ], "type": "object", "properties": { "content": { "type": "array", "description": "Page content and number of elements is restricted by page size", "items": { "$ref": "#/components/schemas/ContactData" } }, "nextPageToken": { "type": "string", "description": "Pagination token to retrieve the next page" }, "prevPageToken": { "type": "string", "description": "Pagination token to retrieve the previous page" }, "totalElements": { "type": "integer", "description": "Total number of elements", "format": "int64", "example": 25 } }, "description": "Page token representation for search result" }, "CreateContactChannelRequest": { "required": [ "channelId", "type" ], "type": "object", "properties": { "channelId": { "type": "string", "description": "Contact channel id (in case phone number - in E164 international format)", "example": "+15553456783" }, "type": { "type": "string", "description": "Contact channel type", "example": "SMS", "enum": [ "SMS", "WHATSAPP" ] }, "subscriptionState": { "type": "string", "description": "Subscription state", "example": "UNSUBSCRIBED", "enum": [ "SUBSCRIBED", "UNSUBSCRIBED" ] } }, "description": "Contact channel create payload" }, "CreateContactListRequest": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "string", "description": "List id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, "description": "Contact creation list payload" }, "CreateCustomFieldRequest": { "required": [ "id", "value" ], "type": "object", "properties": { "id": { "type": "string", "description": "Custom Field id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" }, "value": { "type": "string", "description": "Custom field value", "example": "John" } }, "description": "Contact custom field create payload" }, "CreateContactRequest": { "required": [ "channels" ], "type": "object", "properties": { "firstName": { "type": "string", "description": "Contact first name", "example": "Adam" }, "lastName": { "type": "string", "description": "Contact last name", "example": "Smith" }, "alias": { "type": "string", "description": "Contact alias. Used as an alternative name for your contact, as well as an email handle for email to sms", "example": "user1234" }, "dateOfBirth": { "type": "string", "description": "Date of birth", "format": "date", "example": "2022-08-18" }, "country": { "type": "string", "description": "Country", "example": "US" }, "state": { "type": "string", "description": "State", "example": "CA" }, "location": { "type": "string", "description": "Location", "example": "Sunset Blvd" }, "note": { "type": "string", "description": "Note", "example": "Note" }, "channels": { "type": "array", "description": "Contact channels", "items": { "$ref": "#/components/schemas/CreateContactChannelRequest" } }, "lists": { "type": "array", "description": "Contact lists", "items": { "$ref": "#/components/schemas/CreateContactListRequest" } }, "customFields": { "type": "array", "description": "Contact custom fields", "items": { "$ref": "#/components/schemas/CreateCustomFieldRequest" } } }, "description": "Contact create payload" }, "UpdateContactChannelRequest": { "required": [ "channelId", "type" ], "type": "object", "properties": { "channelId": { "type": "string", "description": "Contact channel id (in case phone number - in E164 international format)", "example": "+15553456783" }, "type": { "type": "string", "description": "Contact channel type", "example": "SMS", "enum": [ "SMS", "WHATSAPP" ] }, "subscriptionState": { "type": "string", "description": "Subscription state", "example": "UNSUBSCRIBED", "enum": [ "SUBSCRIBED", "UNSUBSCRIBED" ] } }, "description": "Contact channel update payload" }, "UpdateContactRequest": { "type": "object", "properties": { "firstName": { "type": "string", "description": "Contact first name", "example": "Adam" }, "lastName": { "type": "string", "description": "Contact last name", "example": "Smith" }, "alias": { "type": "string", "description": "Contact alias. Used as an alternative name for your contact, as well as an email handle for email to sms", "example": "user1234" }, "dateOfBirth": { "type": "string", "description": "Date of birth", "format": "date", "example": "2022-08-18" }, "country": { "type": "string", "description": "Country", "example": "US" }, "state": { "type": "string", "description": "State", "example": "CA" }, "location": { "type": "string", "description": "Location", "example": "Sunset Blvd" }, "note": { "type": "string", "description": "Note", "example": "Note" }, "channels": { "type": "array", "description": "Contact channels", "items": { "$ref": "#/components/schemas/UpdateContactChannelRequest" } }, "lists": { "type": "array", "description": "Contact lists", "items": { "$ref": "#/components/schemas/CreateContactListRequest" } }, "customFields": { "type": "array", "description": "Contact custom fields", "items": { "$ref": "#/components/schemas/CreateCustomFieldRequest" } } }, "description": "Contact update payload" }, "GetListsRequest": { "type": "object", "properties": { "nextPageToken": { "type": "string" }, "prevPageToken": { "type": "string" }, "pageSize": { "maximum": 1000, "type": "integer", "format": "int32" }, "listIds": { "type": "array", "items": { "type": "string", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, "alias": { "type": "string" }, "name": { "type": "string" } }, "description": "Get contact lists page filter" }, "ListData": { "required": [ "accountId", "alias", "createdDate", "id", "lastModifiedDate", "name", "vendorId" ], "type": "object", "properties": { "id": { "type": "string", "description": "List id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" }, "accountId": { "type": "string", "description": "Account id" }, "vendorId": { "type": "string", "description": "Vendor id" }, "name": { "type": "string", "description": "List name", "example": "My group" }, "alias": { "type": "string", "description": "List alias", "example": "VIP group" }, "createdDate": { "type": "string", "description": "Create date", "format": "date-time", "example": "2022-08-18T09:15:03.112Z" }, "lastModifiedDate": { "type": "string", "description": "Last modified date", "format": "date-time", "example": "2022-08-18T09:15:03.112Z" } }, "description": "List details data" }, "PageTokenDtoListData": { "required": [ "content", "totalElements" ], "type": "object", "properties": { "content": { "type": "array", "description": "Page content and number of elements is restricted by page size", "items": { "$ref": "#/components/schemas/ListData" } }, "nextPageToken": { "type": "string", "description": "Pagination token to retrieve the next page" }, "prevPageToken": { "type": "string", "description": "Pagination token to retrieve the previous page" }, "totalElements": { "type": "integer", "description": "Total number of elements", "format": "int64", "example": 25 } }, "description": "Page token representation for search result" }, "CreateListRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "Group name", "example": "My group" }, "alias": { "type": "string", "description": "Group alias", "example": "Group1" } }, "description": "Contact list create payload" }, "UpdateListRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string", "description": "Contact list name", "example": "My list" }, "alias": { "type": "string", "description": "Contact list alias", "example": "List1" } }, "description": "Contact list update payload" }, "UpdateContactsListRequest": { "type": "object", "properties": { "contactsToAddIds": { "maxItems": 1000, "minItems": 0, "type": "array", "items": { "type": "string", "description": "List of contacts to add to the list in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, "contactsToRemoveIds": { "maxItems": 1000, "minItems": 0, "type": "array", "items": { "type": "string", "description": "List of contacts to remove from the list in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } } }, "description": "Contacts list update payload" }, "GetCustomFieldsRequest": { "type": "object", "properties": { "nextPageToken": { "type": "string" }, "prevPageToken": { "type": "string" }, "pageSize": { "maximum": 1000, "type": "integer", "format": "int32" }, "customFieldIds": { "type": "array", "items": { "type": "string", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" } }, "label": { "type": "string" }, "mergeTag": { "type": "string" } }, "description": "Get custom fields page filter" }, "CustomFieldData": { "required": [ "accountId", "createdDate", "id", "label", "lastModifiedDate", "maxLength", "mergeTag", "type", "vendorId" ], "type": "object", "properties": { "id": { "type": "string", "description": "Custom field id in UUID format", "format": "uuid", "example": "025e93d3-051b-43f9-b12e-4b5842228dee" }, "accountId": { "type": "string", "description": "Account id", "example": "accountId_67846328" }, "vendorId": { "type": "string", "description": "Vendor id" }, "label": { "type": "string", "description": "Custom field label", "example": "Contact name" }, "mergeTag": { "type": "string", "description": "Custom field merge tag", "example": "contact_name" }, "maxLength": { "type": "integer", "description": "Custom field max length", "format": "int32", "example": 30 }, "type": { "type": "string", "description": "Custom field type", "example": "DATE", "enum": [ "DATE", "NUMBER", "PHONE", "TEXT", "URL", "ZIP_CODE", "NAME", "EMAIL" ] }, "createdDate": { "type": "string", "description": "Create date", "format": "date-time", "example": "2022-08-18T09:15:03.112Z" }, "lastModifiedDate": { "type": "string", "description": "Last modified date", "format": "date-time", "example": "2022-08-18T09:15:03.112Z" } }, "description": "Custom field data" }, "PageTokenDtoCustomFieldData": { "required": [ "content", "totalElements" ], "type": "object", "properties": { "content": { "type": "array", "description": "Page content and number of elements is restricted by page size", "items": { "$ref": "#/components/schemas/CustomFieldData" } }, "nextPageToken": { "type": "string", "description": "Pagination token to retrieve the next page" }, "prevPageToken": { "type": "string", "description": "Pagination token to retrieve the previous page" }, "totalElements": { "type": "integer", "description": "Total number of elements", "format": "int64", "example": 25 } }, "description": "Page token representation for search result" }, "CustomFieldCreateRequest": { "required": [ "label", "maxLength", "mergeTag", "type" ], "type": "object", "properties": { "label": { "type": "string", "description": "Custom field label", "example": "Contact name" }, "mergeTag": { "type": "string", "description": "Custom field merge tag", "example": "contact_name" }, "maxLength": { "type": "integer", "description": "Custom field max length", "format": "int32", "example": 30 }, "type": { "type": "string", "description": "Custom field type", "example": "DATE", "enum": [ "DATE", "NUMBER", "PHONE", "TEXT", "URL", "ZIP_CODE", "NAME", "EMAIL" ] } }, "description": "Custom field create payload" }, "UpdateCustomFieldRequest": { "type": "object", "properties": { "label": { "type": "string", "description": "Custom field label", "example": "Contact name" }, "maxLength": { "type": "integer", "description": "Custom field max length", "format": "int32", "example": 30 } }, "description": "Custom field update payload" }, "DeliveryReportWebhookPayload": { "title": "DeliveryReportWebhookPayload", "type": "object", "description": "Default/example payload for a delivery report webhook (`ENROUTE_DR`, `SUBMITTED_DR`, `DELIVERED_DR`, `EXPIRED_DR`, `REJECTED_DR`, `FAILED_DR`), built from the sample `template` shown on the Create webhook operation. The actual JSON structure sent to your `url` is fully controlled by the `template` you configure — this describes the payload produced by that sample template, not a fixed contract.\n\nAdditional template variables are available to delivery report templates but are *not* part of this default shape — add them to your own `template` if you want them: `$billingUnits` (billing units for the report, which also requires the \"Enable billing units in Delivery Reports and Callbacks\" switch in your account's API settings), `$retryCount` (webhook delivery retry count), and `$format` (service type; the older `$type` alias is deprecated). See the Template Parameters table on the Create webhook operation for the full list.", "properties": { "delivery_report_id": { "type": "string", "description": "Unique ID for this delivery report", "format": "uuid", "example": "01e1fa0a-6e27-4945-9cdb-18644b4de043" }, "source_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this delivery report was received. Template variable `$sourceAddress`.", "example": "+61491570156" }, "date_received": { "type": "string", "description": "The date and time at which this delivery report was generated in UTC. Template variable `$receivedTimestamp`.", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "status": { "$ref": "#/components/schemas/Status" }, "delay": { "type": "string", "deprecated": true, "description": "Deprecated, no longer in use. In the sample `template` this is the hardcoded literal `\"0\"` rather than a template variable — there is no `$delay` parameter — so it always renders as `\"0\"`. Retained only for backward compatibility with existing integrations.", "example": "0" }, "submitted_date": { "type": "string", "description": "The date and time when the message status changed in UTC. For a delivered DR this may indicate the time at which the message was received on the handset. Template variable `$submittedTimestamp`.", "format": "date-time", "example": "2016-11-03T11:49:02.807Z" }, "message_id": { "type": "string", "description": "Unique ID of the original message. Template variable `$messageId`.", "format": "uuid", "example": "877c19ef-fa2e-4cec-827a-e1df9b5509f7" }, "original_text": { "type": "string", "description": "Text of the original message. Template variable `$mtContent`.", "example": "Hello back" }, "vendor_account_id": { "$ref": "#/components/schemas/VendorAccountId" }, "error_code": { "type": "string", "description": "Status code for this delivery report. Template variable `$statusCode`.", "example": "220" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Any metadata that was included in the original submit message request. Template variable `$metadata`. Keys and values are both strings." } } }, "SmsReceivedWebhookPayload": { "title": "SmsReceivedWebhookPayload", "type": "object", "description": "Default/example payload for an inbound SMS reply webhook (`RECEIVED_SMS` only — `OPT_OUT_SMS` is dispatched through a separate code path with its own shape, see `OptOutWebhookPayload`), built from the sample `template` shown on the Create webhook operation. The actual JSON structure sent to your `url` is fully controlled by the `template` you configure — this describes the payload produced by that sample template, not a fixed contract.", "properties": { "account_id": { "type": "string", "description": "The account that received the reply. Template variable `$accountId`.", "example": "DeveloperPortal7000" }, "reply_id": { "type": "string", "description": "Unique ID of this reply. Template variable `$replyId`.", "format": "uuid", "example": "a175e797-2b54-468b-9850-41a3eab32f74" }, "destination_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this reply was sent to. Template variable `$destinationAddress`.", "example": "+61491593156" }, "source_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this reply was received from. Template variable `$sourceAddress`.", "example": "+61491570156" }, "date_received": { "type": "string", "description": "Date time when the reply was received. Template variable `$receivedTimestamp`.", "format": "date-time", "example": "2016-12-07T08:44:00.850Z" }, "message_id": { "type": "string", "description": "Unique ID of the original message. Template variable `$messageId`.", "format": "uuid", "example": "877c19ef-fa2e-4cec-827a-e1df9b5509f7" }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the reply. Template variable `$moContent`.", "example": "Hello back" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Any metadata that was included in the original submit message request. Template variable `$metadata`. Keys and values are both strings." } } }, "WebhookAttachment": { "title": "WebhookAttachment", "type": "object", "description": "A media attachment included in an MMS reply webhook payload, rendered from the `$attachments` template variable.", "properties": { "content_type": { "type": "string", "description": "MIME type of the attachment. Template variable `$entry.contentType`.", "example": "image/png" }, "content": { "type": "string", "description": "Base64-encoded content of the attachment. Template variable `$entry.base64`.", "format": "byte" }, "original_name": { "type": "string", "description": "Original file name of the attachment. Template variable `$entry.originalName`.", "example": "file.png" } } }, "MmsReceivedWebhookPayload": { "title": "MmsReceivedWebhookPayload", "type": "object", "description": "Default/example payload for an inbound MMS reply webhook (`RECEIVED_MMS`), built from the sample `template` shown on the Create webhook operation. Same shape as the SMS reply webhook, except that the sample template branches on whether the reply carried media: it emits `attachments` when the reply has media, and falls back to `content` when it does not. The two are mutually exclusive in the default template. The actual JSON structure sent to your `url` is fully controlled by the `template` you configure — this describes the payload produced by that sample template, not a fixed contract.", "properties": { "account_id": { "type": "string", "description": "The account that received the reply. Template variable `$accountId`.", "example": "DeveloperPortal7000" }, "reply_id": { "type": "string", "description": "Unique ID of this reply. Template variable `$replyId`.", "format": "uuid", "example": "a175e797-2b54-468b-9850-41a3eab32f74" }, "destination_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this reply was sent to. Template variable `$destinationAddress`.", "example": "+61491593156" }, "source_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this reply was received from. Template variable `$sourceAddress`.", "example": "+61491570156" }, "date_received": { "type": "string", "description": "Date time when the reply was received. Template variable `$receivedTimestamp`.", "format": "date-time", "example": "2016-12-07T08:44:00.850Z" }, "message_id": { "type": "string", "description": "Unique ID of the original message. Template variable `$messageId`.", "format": "uuid", "example": "877c19ef-fa2e-4cec-827a-e1df9b5509f7" }, "attachments": { "type": "array", "description": "Media attachments on the reply. Template variable `$attachments`. Present only when the reply carried media; otherwise the sample template emits `content` instead.", "items": { "$ref": "#/components/schemas/WebhookAttachment" } }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the reply. Template variable `$moContent`. Present only when the reply carried no media attachments — the sample template emits either `attachments` or `content`, never both.", "example": "Hello back" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Any metadata that was included in the original submit message request. Template variable `$metadata`. Keys and values are both strings." } } }, "OptOutWebhookPayload": { "title": "OptOutWebhookPayload", "type": "object", "description": "Suggested payload for an opt-out webhook (`OPT_OUT_SMS`). Unlike the delivery report and reply webhooks, no sample `template` exists in current prose for this event, so this is *not* a transcribed default — it is a suggested shape built from the template variables the platform makes available to opt-out notifications.\n\n**Important:** `OPT_OUT_SMS` is dispatched as a notification with its own `$notificationId`, not as a reply. The `$replyId` / `$moId` variables used by the `RECEIVED_SMS` and `RECEIVED_MMS` templates are **not available** for this event — a template referencing them will render the literal text `$replyId` rather than an ID. Use `$notificationId` instead.\n\nThe actual JSON structure sent to your `url` is fully controlled by the `template` you configure.", "properties": { "notification_id": { "type": "string", "description": "Unique ID of this opt-out notification. Template variable `$notificationId`.", "format": "uuid", "example": "3e6e6b1a-6c1d-4b1a-9c1e-6f1a6b1a6c1d" }, "account_id": { "type": "string", "description": "The account that received the opt-out. Template variable `$accountId`.", "example": "DeveloperPortal7000" }, "destination_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this opt-out was sent to. Template variable `$destinationAddress`.", "example": "+61491593156" }, "source_number": { "maxLength": 15, "minLength": 1, "type": "string", "description": "Address from which this opt-out was received from. Template variable `$sourceAddress`.", "example": "+61491570156" }, "date_received": { "type": "string", "description": "Date time when the opt-out was received. Template variable `$receivedTimestamp`.", "format": "date-time", "example": "2016-12-07T08:44:00.850Z" }, "message_id": { "type": "string", "description": "Unique ID of the original message. Template variable `$messageId`. May be absent when the opt-out is unsolicited — that is, when the recipient sends a stop keyword with no preceding message to correlate against — so treat this as optional rather than guaranteed.", "format": "uuid", "example": "877c19ef-fa2e-4cec-827a-e1df9b5509f7" }, "content": { "maxLength": 5000, "minLength": 1, "type": "string", "description": "Content of the opt-out message. Template variable `$moContent`.", "example": "STOP" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Any metadata that was included in the original submit message request. Template variable `$metadata`. Keys and values are both strings." } } } }, "responses": { "PayloadTooLarge": { "description": "Maximum upload size exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "UnsupportedMediaType": { "description": "Unsupported media type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "PaymentRequired": { "description": "Current user does not have permissions to perform the requested operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "Unauthorized": { "description": "No valid authentication details were provided" }, "BadRequest": { "description": "Request has incorrect values", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvalidInputApiError" } } } }, "Forbidden": { "description": "The authenticated user or account doesn't have permission" }, "Conflict": { "description": "Conflict. The entity already exists.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "InternalServerError": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "RequestNotRecognised": { "description": "Request not recognised" }, "BadGateway": { "description": "Invalid server response" }, "ServerUnavailable": { "description": "Server currently unavailable" }, "GatewayTimeout": { "description": "Gateway time out" }, "NotFound": { "description": "The specified resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "headers": { "ExpiresAfter": { "description": "date in UTC when token expires", "schema": { "type": "string", "format": "date-time" } } }, "securitySchemes": { "basic_auth": { "type": "http", "scheme": "basic", "description": "HTTP Basic authentication using your API key as the username and API secret as the password. See the Basic Authentication guide tag.\n" }, "hmac_auth": { "type": "apiKey", "in": "header", "name": "Authorization", "description": "HMAC request signing. Place the full `hmac username=...` credential in the Authorization header. See the HMAC Authentication guide tag.\n" }, "bearer_auth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Bearer JWT authentication used by selected messaging-reports async download endpoints. Prefer Basic or HMAC for all other operations.\n" } } }, "x-tagGroups": [ { "name": "Guides", "tags": [ "Basic Authentication", "HMAC Authentication", "Sub-accounts" ] }, { "name": "Messaging", "tags": [ "Messages", "Delivery Reports", "Replies" ] }, { "name": "Numbers", "tags": [ "Source Address", "Number Authorisation", "Dedicated Numbers" ] }, { "name": "Webhooks and security", "tags": [ "Webhooks Management", "Webhook Payloads", "Signature Key Management" ] }, { "name": "Reporting", "tags": [ "Messaging Reports", "Short Trackable Links Reports" ] }, { "name": "Contacts", "tags": [ "Contacts" ] } ] }