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": "[email protected]",
  "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"
}

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": "[email protected]",
  "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

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

string

Example:

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

file

object

Show child attributes

file.@id

string<iri-reference>

File IRI reference

Example:

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

file.@type

string

default:File

file.id

string<uuid>

Example:

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

file.type

string

file.resource

string

file.mimeType

string

file.extension

string

file.size

integer

Example:

40544

file.filename

string

file.createdAt

string

Date and time the resource was created

Example:

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

file.updatedAt

string

Date and time the resource was last updated

Example:

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

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

Example:

20060152922

person

object

Person information. Null when the taxpayer is not a physical person.

Show child attributes

person.fullName

string

Example:

"Pedro Infante Cruz"

person.firstName

string

Example:

"Pedro"

person.middleName

string

Example:

"Infante"

person.lastName

string

Example:

"Cruz"

person.curp

string

Example:

"PEIC90110UEYBVT85"

company

object

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

Show child attributes

company.legalName

string

Example:

"APPLE OPERATIONS MEXICO"

company.tradeName

string

Example:

"APPLE OPERATIONS MEXICO S.A. DE C.V."

company.entityType

string

Example:

"SOCIEDAD ANONIMA DE CAPITAL VARIABLE"

string

Example:

"[email protected]"

phone

string

Maximum string length: 10

Example:

"5512345678"

address

object

Show child attributes

address.streetReferences

string[]

Minimum array length: 1

address.streetNumber

string

Example:

"8124"

address.buildingNumber

string

Example:

"496"

address.locality

string

Example:

"TUXTLA GUTIERREZ"

address.municipality

string

Example:

"TUXTLA GUTIERREZ"

address.postalCode

string

Example:

"29000"

address.state

string

Example:

"CHIAPAS"

address.streetName

string

Example:

"Plaza Jorge Luis"

address.streetType

string

Example:

"Calle"

address.neighborhood

string

Example:

"Paseo Ricardo"

address.statusRaw

string

Example:

"LOCALIZADO - Domicilio Localizado"

economicActivities

object[]

Show child attributes

economicActivities.name

string

Example:

"Asalariado"

economicActivities.order

string

Example:

"1"

economicActivities.percentage

string

Example:

"100"

economicActivities.endDate

string<date>

economicActivities.startDate

string<date>

taxRegimes

object[]

Show child attributes

taxRegimes.code

integer

Example:

601

taxRegimes.name

string

Example:

"Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios"

taxRegimes.endDate

string<date>

taxRegimes.startDate

string<date>

obligations

object[]

Show child attributes

obligations.description

string

Example:

"Pago definitivo mensual de IVA."

obligations.dueDate

string

Example:

"A más tardar el día 17 del mes inmediato posterior al periodo que corresponda."

obligations.endDate

string<date>

obligations.startDate

string<date>

startedOperationsAt

string<date-time>

status

string

Example:

"Activo"

statusUpdatedAt

string<date-time>

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"

List tax compliance checks List all taxpayer´s tax status

⌘I

Core Resources

Extractions

Datasource: SAT

Datasource: RPC

Datasource: RUG

Datasource: Syntage

Datasource: Buró de Crédito

Insights

Webhooks

Miscellaneous

Retrieve a tax status

Authorizations

Path Parameters

Response