> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# Overview

Welcome to the SignalWire REST API. Every capability on the platform — placing calls, sending messages, managing phone numbers, running video rooms, building AI agents — is reachable through a consistent set of HTTP endpoints under your Space's subdomain.

Requests and responses are JSON over HTTPS, authenticated with your Project ID and API token. Endpoints follow standard [REST](https://en.wikipedia.org/wiki/REST) conventions: predictable resource URLs, conventional HTTP verbs, and structured status codes for every outcome — including errors.

## Core concepts

Before making your first call, get oriented with the shared conventions across every endpoint:

#### [Authorization](/docs/apis/authorization)

Authenticate with Basic Auth using your Project ID and API token, or use Bearer tokens for client-side apps.

#### [Base URL](/docs/apis/base-url)

Every request goes through your Space's subdomain over HTTPS. See how to find your subdomain and how request URLs are structured.

#### [Data formats](/docs/apis/data-formats)

UTC ISO 8601 timestamps, E.164 phone numbers, and case-sensitive parameter names across every request and response.

#### [Paging](/docs/apis/paging)

List endpoints return paged results. Use the `links` envelope to walk through the full set safely.

#### [Error codes](/docs/apis/error-codes)

HTTP status codes, the structured error response shape, and a full reference of error code values.

## Use the REST API from your code

The SignalWire [Server SDKs](/docs/server-sdks) wrap every REST endpoint in idiomatic, type-safe client libraries — use them in production code instead of crafting HTTP requests by hand. Each SDK exposes the full REST surface (phone numbers, calling, messaging, video, fabric resources, and more) through namespaced resource objects with standard CRUD operations. Pick the language that matches your stack from the [Server SDKs overview](/docs/server-sdks).

## Try it in Postman

For developers who prefer working in Postman, we maintain an official collection that mirrors every REST endpoint with pre-built requests, example payloads, and a configurable environment for your SignalWire credentials. It's a fully supported alternative to the API playground built into these docs.

### Open the collection in Postman

Click **Run in Postman** to fork the collection into your own Postman workspace.

[<img src="https://run.pstmn.io/button.svg" alt="Run In Postman" />](https://god.gw.postman.com/run-collection/16445495-86c9916b-baa8-4bb3-b62d-d4ae86b12d61?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D16445495-86c9916b-baa8-4bb3-b62d-d4ae86b12d61%26entityType%3Dcollection%26workspaceId%3D4f34e511-485e-4462-a432-20fbc2d1db33)

### Set your credentials

Open the collection's **Variables** tab and fill in the three values from the [API pane](https://my.signalwire.com?page=credentials) of your SignalWire Dashboard:

| Variable     | Value                                  |
| ------------ | -------------------------------------- |
| `space_name` | Your Space subdomain (e.g., `example`) |
| `project_id` | Your **Project ID**                    |
| `api_token`  | Your **API Token**                     |

#### Subscriber endpoints (optional)

A small number of endpoints — those scoped to an individual [subscriber](/docs/platform/subscribers) rather than a project — authenticate with a Subscriber Access Token (SAT) instead of Basic Auth. If you plan to call those, also set the `subscriber_token` variable to a token generated via the [Create Subscriber Token endpoint](/docs/apis/rest/subscribers/tokens/create-subscriber-token). Endpoints that need it have their **Authorization** tab set to **Bearer Token** referencing `{{subscriber_token}}`; you don't need to set it to use the rest of the collection.

### Send your first request

Open any endpoint — try **Phone Numbers** to list the numbers on your project, or **Messages** to fire off a test SMS — and hit **Send**. The collection uses your credentials automatically.

Be sure to subscribe to the [SignalWire Community](https://signalwire.community) for information on new features and changes to the API and language libraries.