Skip to main content
GET
Retrieve a tax status

Authorizations

X-API-Key
string
header
required

Your API key is available in the Production and Sandbox dashboards.

Path Parameters

id
string<uuid>
required

Response

Tax status resource response

@context
string
default:/contexts/TaxStatus
@id
string<iri-reference>

Tax Status IRI reference

Example:

"/tax-status/91106968-1abd-4d64-85c1-4e73d96fb997"

@type
string
default:TaxStatus
id
string

Tax status ID

Example:

"91106968-1abd-4d64-85c1-4e73d96fb997"

file
object
Example:
rfc
string

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

cif
string

SAT CIF identifier

Example:

20060152922

person
object | null

Physical person information extracted from the SAT tax status document. Null when the entity is not a physical person.

company
object | null

Company information. Null when the taxpayer is not a legal person.

email
string

Email address reported in the tax status document

Example:

"my-email@test.com"

phone
string

Phone number reported in the tax status document

Maximum string length: 10
Example:

"5512345678"

address
object

Fiscal address from the SAT tax status document

economicActivities
object[]
taxRegimes
object[]
obligations
object[]
startedOperationsAt
string<date-time>

Date when SAT reports the taxpayer started operations

status
string

Taxpayer status reported by SAT

Example:

"Activo"

statusUpdatedAt
string<date-time>

Date when the SAT taxpayer status was last updated

createdAt
string

Date and time the resource was created

Example:

"2020-01-01T12:15:00.000Z"

updatedAt
string

Date and time the resource was last updated

Example:

"2020-01-01T12:15:00.000Z"