Get a customer service record

GET 
/customer_service_records/:customer_service_record_id

Get a specific customer service record.

Request

Path Parameters

customer_service_record_id stringrequired

The ID of the customer service record

Responses

201: Successful Response

application/json

• Schema
• Example (from schema)

Schema

data

object

id uuid

Uniquely identifies this customer service record

phone_number string

The phone number of the customer service record.

status string

Possible values: [pending, completed, failed]

The status of the customer service record

error_message string

The error message in case status is failed. This field would be null in case of pending or completed status.

result

object

The result of the CSR request. This field would be null in case of pending or failed status.

carrier_name string

The name of the carrier that the customer service record is for.

associated_phone_numbers string[]

The associated phone numbers of the customer service record.

admin

object

The admin of the customer service record.

name string

The name of the customer service record.

billing_phone_number string

The billing phone number of the customer service record.

account_number string

The account number of the customer service record.

authorized_person_name string

The authorized person name of the customer service record.

The admin of the customer service record.

address

object

The address of the customer service record

administrative_area string

The state of the address

locality string

The city of the address

postal_code string

The zip code of the address

street_address string

The street address

full_address string

The full address

The address of the customer service record

record_type string

Identifies the type of the resource.

created_at date-time

ISO 8601 formatted date indicating when the resource was created.

updated_at date-time

ISO 8601 formatted date indicating when the resource was created.

{
  "data": {
    "id": "f1486bae-f067-460c-ad43-73a92848f902",
    "phone_number": "+12065551212",
    "status": "completed",
    "error_message": "CSR information not available.",
    "result": {
      "carrier_name": "ABC CARRIER, INC.",
      "associated_phone_numbers": [
        "+12065551212"
      ],
      "admin": {
        "name": "John Doe",
        "billing_phone_number": "+12065551212",
        "account_number": "1234567890",
        "authorized_person_name": "John Doe"
      },
      "address": {
        "administrative_area": "NY",
        "locality": "New York",
        "postal_code": "10001",
        "street_address": "123 Main St",
        "full_address": "123 Main St; New York; NY; 10001"
      }
    },
    "record_type": "customer_service_record",
    "created_at": "2021-03-19T10:07:15.527Z",
    "updated_at": "2021-03-19T10:07:15.527Z"
  }
}

401: The required authentication headers were either invalid or not included in the request.

application/json

• Schema
• Example (from schema)

Schema

errors object[]

{
  "errors": [
    {
      "code": "10009",
      "title": "Authentication failed",
      "detail": "The required authentication headers were either invalid or not included in the request.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10009"
      }
    }
  ]
}

403: You do not have permission to perform the requested action on the specified resource or resources.

application/json

• Schema
• Example (from schema)

Schema

errors object[]

{
  "errors": [
    {
      "code": "10010",
      "title": "Authorization failed",
      "detail": "You do not have permission to perform the requested action on the specified resource or resources.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10010"
      }
    }
  ]
}

404: Resource not found

application/json

• Schema
• Example (from schema)

Schema

errors object[]

{
  "errors": [
    {
      "code": "10005",
      "title": "Resource not found",
      "detail": "The requested resource or URL could not be found.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10005"
      }
    }
  ]
}

500: An unexpected error occurred.

application/json

• Schema
• Example (from schema)

Schema

errors object[]

{
  "errors": [
    {
      "code": "10007",
      "title": "Unexpected error",
      "detail": "An unexpected error occurred.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10007"
      }
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://apidev.telnyx.com/v2/customer_service_records/:customer_service_record_id' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 201
• 401
• 403
• 404
• 500

---

{
  "data": {
    "id": "f1486bae-f067-460c-ad43-73a92848f902",
    "phone_number": "+12065551212",
    "status": "completed",
    "error_message": "CSR information not available.",
    "result": {
      "carrier_name": "ABC CARRIER, INC.",
      "associated_phone_numbers": [
        "+12065551212"
      ],
      "admin": {
        "name": "John Doe",
        "billing_phone_number": "+12065551212",
        "account_number": "1234567890",
        "authorized_person_name": "John Doe"
      },
      "address": {
        "administrative_area": "NY",
        "locality": "New York",
        "postal_code": "10001",
        "street_address": "123 Main St",
        "full_address": "123 Main St; New York; NY; 10001"
      }
    },
    "record_type": "customer_service_record",
    "created_at": "2021-03-19T10:07:15.527Z",
    "updated_at": "2021-03-19T10:07:15.527Z"
  }
}

{
  "errors": [
    {
      "code": "10009",
      "title": "Authentication failed",
      "detail": "The required authentication headers were either invalid or not included in the request.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10009"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "10010",
      "title": "Authorization failed",
      "detail": "You do not have permission to perform the requested action on the specified resource or resources.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10010"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "10005",
      "title": "Resource not found",
      "detail": "The requested resource or URL could not be found.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10005"
      }
    }
  ]
}

{
  "errors": [
    {
      "code": "10007",
      "title": "Unexpected error",
      "detail": "An unexpected error occurred.",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {
        "url": "https://developers.telnyx.com/docs/overview/errors/10007"
      }
    }
  ]
}