Add a do-not-call entry

POST

/v1/suppressions

curl https://api.pacepayments.ai/v1/suppressions \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: 7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11' \
  --header 'Content-Type: application/json' \
  --data '{
  "phone": "+493514713160",
  "subject_reference": "CUST-88213",
  "scope": "voice"
}'

requests.post(
    "https://api.pacepayments.ai/v1/suppressions",
    headers={
      "Authorization": "Bearer <token>",
      "Idempotency-Key": "7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11",
      "Content-Type": "application/json"
    },
    json={
      "phone": "+493514713160",
      "subject_reference": "CUST-88213",
      "scope": "voice"
    }
)

fetch('https://api.pacepayments.ai/v1/suppressions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Idempotency-Key': '7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '+493514713160',
    subject_reference: 'CUST-88213',
    scope: 'voice'
  })
})

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.pacepayments.ai/v1/suppressions");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<token>");
request.Headers.TryAddWithoutValidation("Idempotency-Key", "7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11");
request.Content = new StringContent(
"""
{
  "phone": "+493514713160",
  "subject_reference": "CUST-88213",
  "scope": "voice"
}
""",
System.Text.Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);

$ch = curl_init("https://api.pacepayments.ai/v1/suppressions");

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer <token>', 'Idempotency-Key: 7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11', 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  'phone' => '+493514713160',
  'subject_reference' => 'CUST-88213',
  'scope' => 'voice'
]));

curl_exec($ch);

curl_close($ch);

package main

import (
  "fmt"
  "io"
  "net/http"
  "strings"
)

func main() {
  requestUrl := "https://api.pacepayments.ai/v1/suppressions"

  payload := strings.NewReader(`{
  "phone": "+493514713160",
  "subject_reference": "CUST-88213",
  "scope": "voice"
}`)

  req, _ := http.NewRequest("POST", requestUrl, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Idempotency-Key", "7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"phone\": \"+493514713160\",\n  \"subject_reference\": \"CUST-88213\",\n  \"scope\": \"voice\"\n}");
Request request = new Request.Builder()
  .url("https://api.pacepayments.ai/v1/suppressions")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Idempotency-Key", "7f8c9a4e-2b1d-4e5f-9a3c-d10f2b6e8c11")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

Authorizations

pace_oauth2
suppressions:write

Parameters

Header Parameters

Idempotency-Key

Any of:

string
null

string

One unique key per logical request (a UUID is recommended). The response is stored against (tenant, key, method, RESOLVED path) - the same key against a different path returns 409 idempotency_key_conflict. Same key plus same body replays the stored response for 48 hours.

Request Body^required

application/json

SuppressionCreate

object

phone

Any of:

string
null

string

<= 32 characters

subject_reference

Any of:

string
null

string

>= 1 characters <= 128 characters

scope

Scope

V1 only makes calls, so an entry blocks voice contact. An open registry, so further channels can be added without a break - but only voice is accepted today.

string

default: voice

reason

Any of:

string
null

string

<= 64 characters

note

Any of:

string
null

string

<= 500 characters

Responses

201

Successful Response

application/json

Suppression

object

required

string

phone

Any of:

string
null

string

subject_reference

Any of:

string
null

string

scope

required

Scope

string

reason

Any of:

string
null

string

note

Any of:

string
null

string

source

required

Source

Where the entry came from. in_call_request means the person objected during a call - that entry canNOT be deleted over the API.

string

created_at

required

Created At

string format: date-time

Example

{
  "id": "sup_01J40M3V"
}

401

No valid access token. Client action: request a new token from the token endpoint and retry once. Repeated 401 with a fresh token means the client registration is disabled - contact Pace, do not retry in a loop.

application/problem+json

Problem

object

type

required

Type

string

title

required

Title

string

status

required

Status

integer

code

required

Code

string

detail

Any of:

string
null

string

instance

Any of:

string
null

string

trace_id

Any of:

string
null

string

errors

Any of:

Array<object>
null

Array<object>

FieldError

object

pointer

required

Pointer

RFC 6901 pointer to the offending field in the request body. Errors outside the body carry their source as the first segment (e.g. /query/limit).

string

code

required

Code

Stable field error code (open registry).

string

message

Any of:

string
null

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "trace_id": "example",
  "errors": [
    {
      "pointer": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Authenticated but not permitted. insufficient_scope names the missing scope in detail; feature_not_enabled means the tenant lacks the feature; ip_not_allowlisted means the source IP is not on the client registration’s allowlist; simulate_not_allowed means a sandbox-only simulate block was sent to the live host. None of these are retryable.

application/problem+json

Problem

object

type

required

Type

string

title

required

Title

string

status

required

Status

integer

code

required

Code

string

detail

Any of:

string
null

string

instance

Any of:

string
null

string

trace_id

Any of:

string
null

string

errors

Any of:

Array<object>
null

Array<object>

FieldError

object

pointer

required

Pointer

RFC 6901 pointer to the offending field in the request body. Errors outside the body carry their source as the first segment (e.g. /query/limit).

string

code

required

Code

Stable field error code (open registry).

string

message

Any of:

string
null

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "trace_id": "example",
  "errors": [
    {
      "pointer": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

422

Validation Error

application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}

429

HTTP rate limit (rate_limited) or execution capacity refusal (quota_exceeded, backlog_full) - two distinct layers. Wait for Retry-After, then retry the identical request with the same Idempotency-Key. backlog_full will not clear in seconds; back off to minutes.

application/problem+json

Problem

object

type

required

Type

string

title

required

Title

string

status

required

Status

integer

code

required

Code

string

detail

Any of:

string
null

string

instance

Any of:

string
null

string

trace_id

Any of:

string
null

string

errors

Any of:

Array<object>
null

Array<object>

FieldError

object

pointer

required

Pointer

RFC 6901 pointer to the offending field in the request body. Errors outside the body carry their source as the first segment (e.g. /query/limit).

string

code

required

Code

Stable field error code (open registry).

string

message

Any of:

string
null

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "trace_id": "example",
  "errors": [
    {
      "pointer": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

Headers

Retry-After

integer

Seconds until the next attempt is permitted.

RateLimit-Limit

integer

RateLimit-Remaining

integer

RateLimit-Reset

integer

default

Error (RFC 9457). Branch on code, never on title or detail.

application/problem+json

Problem

object

type

required

Type

string

title

required

Title

string

status

required

Status

integer

code

required

Code

string

detail

Any of:

string
null

string

instance

Any of:

string
null

string

trace_id

Any of:

string
null

string

errors

Any of:

Array<object>
null

Array<object>

FieldError

object

pointer

required

Pointer

RFC 6901 pointer to the offending field in the request body. Errors outside the body carry their source as the first segment (e.g. /query/limit).

string

code

required

Code

Stable field error code (open registry).

string

message

Any of:

string
null

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "trace_id": "example",
  "errors": [
    {
      "pointer": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

Add a do-not-call entry

Authorizations

Parameters

Header Parameters

Request Bodyrequired

Responses

201

Example

401

Examplegenerated

403

Examplegenerated

422

Examplegenerated

429

Examplegenerated

Headers

default

Examplegenerated

Request Body^required

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated