Get a contact consent report

Returns the current read-only consent report for one contact. Requires an authenticated account administrator; the account and contact are resolved within the authenticated account. Ordinary account reads follow the inherited login-block decision, including its open-suspension value and account-status fallback. Authorized own-account read-only staff impersonation may read a suspended account; membership, administrator authorization, and contact scoping still apply. No query parameters change the report. This report does not write consent state and is not proof that sends are enforced against it.

GET

/

api

/

v1

/

accounts

/

{account_id}

/

contacts

/

{contact_id}

/

consent

Get a contact consent report

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent \
  --header 'api_access_token: <api-key>'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent"

headers = {"api_access_token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

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

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "contact_id": 50,
  "generated_at": "2026-10-22T16:59:53.674Z",
  "history_limit": 100,
  "merged_contact_ids": [],
  "legacy_opt_outs": {
    "amb": [],
    "rcs": []
  },
  "inboxes": []
}

Authorizations

api_access_token

string

header

required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

account_id

integer

required

Account containing the authenticated administrator and contact.

contact_id

integer

required

Contact ID scoped through the authenticated account.

Response

Current report. Empty inboxes mean no ledger events, not proof of consent or that sends are allowed.

Current output of Consent::Report for one account-owned contact.

contact_id

integer

required

Account-owned contact identifier.

generated_at

string<date-time>

required

UTC time at which the report policy answers were evaluated.

history_limit

enum<integer>

required

Current maximum number of newest history events returned per inbox and purpose.

Available options:

100

merged_contact_ids

integer[]

required

Original contact IDs represented by ledger events moved into this contact.

legacy_opt_outs

object

required

Opt-out IDs from the existing AMB and RCS legacy readers.

Show child attributes

inboxes

object[]

required

Inboxes with at least one ledger event for this contact.

Show child attributes

Get a contact consent report

curl --request GET \
  --url https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent \
  --header 'api_access_token: <api-key>'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent"

headers = {"api_access_token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

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

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/consent"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_access_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "contact_id": 50,
  "generated_at": "2026-10-22T16:59:53.674Z",
  "history_limit": 100,
  "merged_contact_ids": [],
  "legacy_opt_outs": {
    "amb": [],
    "rcs": []
  },
  "inboxes": []
}