Skip to main content
GET
/
tax-status
/
{id}
Retrieve a tax status
curl --request GET \
  --url https://api.syntage.com/tax-status/{id} \
  --header 'X-API-Key: <api-key>'
{
  "@context": "/contexts/TaxStatus",
  "@id": "/tax-status/91106968-1abd-4d64-85c1-4e73d96fb997",
  "@type": "TaxStatus",
  "id": "91106968-1abd-4d64-85c1-4e73d96fb997",
  "file": {
    "type": "TaxStatus",
    "resource": "/tax-status/91106968-1abd-4d64-85c1-4e73d96fb997",
    "mimeType": "application/pdf",
    "extension": "pdf",
    "filename": "91106968-1abd-4d64-85c1-4e73d96fb997.pdf"
  },
  "rfc": "PEIC211118IS0",
  "cif": 20060152922,
  "person": {
    "fullName": "Pedro Infante Cruz",
    "firstName": "Pedro",
    "middleName": "Infante",
    "lastName": "Cruz",
    "curp": "PEIC90110UEYBVT85"
  },
  "company": {
    "legalName": "APPLE OPERATIONS MEXICO",
    "tradeName": "APPLE OPERATIONS MEXICO S.A. DE C.V.",
    "entityType": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE"
  },
  "email": "my-email@test.com",
  "phone": "5512345678",
  "address": {
    "streetReferences": [
      "Camiño Galván"
    ],
    "streetNumber": "8124",
    "buildingNumber": "496",
    "locality": "TUXTLA GUTIERREZ",
    "municipality": "TUXTLA GUTIERREZ",
    "postalCode": "29000",
    "state": "CHIAPAS",
    "streetName": "Plaza Jorge Luis",
    "streetType": "Calle",
    "neighborhood": "Paseo Ricardo",
    "statusRaw": "LOCALIZADO - Domicilio Localizado"
  },
  "economicActivities": [
    {
      "name": "Asalariado",
      "order": "1",
      "percentage": "100",
      "endDate": "2023-12-25",
      "startDate": "2023-12-25"
    }
  ],
  "taxRegimes": [
    {
      "code": 601,
      "name": "Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios",
      "endDate": "2023-12-25",
      "startDate": "2023-12-25"
    }
  ],
  "obligations": [
    {
      "description": "Pago definitivo mensual de IVA.",
      "dueDate": "A más tardar el día 17 del mes inmediato posterior al periodo que corresponda.",
      "endDate": "2023-12-25",
      "startDate": "2023-12-25"
    }
  ],
  "startedOperationsAt": "2023-11-07T05:31:56Z",
  "status": "Activo",
  "statusUpdatedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z"
}

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:
{
  "type": "TaxStatus",
  "resource": "/tax-status/91106968-1abd-4d64-85c1-4e73d96fb997",
  "mimeType": "application/pdf",
  "extension": "pdf",
  "filename": "91106968-1abd-4d64-85c1-4e73d96fb997.pdf"
}
​
rfc
string

RFC (Registro Federal de Contribuyentes)

Required string length: 12 - 13
Example:

"PEIC211118IS0"

​
cif
string

SAT CIF identifier

Example:

20060152922

​
person
object

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

​
company
object

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"