Skip to main content
cURL
curl -X POST https://api.origoid.com/mex/social-security/v1/issste-records \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"curp": "TEST900101HDFRRN09"}'
{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Active worker found",
  "data": {
    "personalInfo": {
      "curp": "GOTM850312MDFMRX05",
      "givenNames": "MARIA FERNANDA",
      "firstSurname": "GOMEZ",
      "secondSurname": "TORRES",
      "rfc": "GOTM850312AB1",
      "gender": "M",
      "dateOfBirth": "1985-03-12",
      "maritalStatus": "CASADO",
      "nss": "10567890123"
    },
    "affiliation": {
      "beneficiaryType": "TRABAJADOR",
      "affiliationStatus": "ACTIVO",
      "governmentEntryDate": "2008-01-01",
      "currentPositionStartDate": "2008-01-01",
      "terminationDate": null
    },
    "pensionRegime": {
      "seniorityYears": 19,
      "scheme": "CUENTAS INDIVIDUALES"
    },
    "employment": [
      {
        "agency": "SALUD DE TLAXCALA",
        "payrollOffice": "SALUD DE TLAXCALA",
        "startDate": "2008-01-01",
        "baseSalary": "9611.42",
        "positionType": "BASE",
        "totalCompensation": "14937.00",
        "coverage": "TODOS LOS SEGUROS, PRESTACIONES Y SERVICIOS"
      },
      {
        "agency": "SERVICIOS DE SALUD DEL IMSS PARA EL BIENESTAR",
        "payrollOffice": "IMSS BIENESTAR TLAXCALA",
        "startDate": "2024-03-01",
        "baseSalary": "10452.54",
        "positionType": "BASE",
        "totalCompensation": "29390.20",
        "coverage": "TODOS LOS SEGUROS, PRESTACIONES Y SERVICIOS"
      }
    ],
    "pensions": [],
    "contributionHistory": [
      {
        "agency": "SALUD DE TLAXCALA",
        "payrollOffice": "SALUD DE TLAXCALA",
        "periodType": "NORMAL",
        "startDate": "2008-01-01",
        "endDate": "2010-12-31",
        "baseSalary": "4450.00"
      },
      {
        "agency": "SALUD DE TLAXCALA",
        "payrollOffice": "SALUD DE TLAXCALA",
        "periodType": "NORMAL",
        "startDate": "2011-01-01",
        "endDate": "2012-04-30",
        "baseSalary": "5570.00"
      }
    ],
    "fovissteHistory": [
      {
        "agency": "SALUD DE TLAXCALA",
        "payrollOffice": "SALUD DE TLAXCALA",
        "periodType": "NORMAL",
        "startDate": "2008-01-01",
        "endDate": "2010-12-31",
        "baseSalary": "4450.00"
      },
      {
        "agency": "SALUD DE TLAXCALA",
        "payrollOffice": "SALUD DE TLAXCALA",
        "periodType": "NORMAL",
        "startDate": "2011-01-01",
        "endDate": "2012-04-30",
        "baseSalary": "5570.00"
      }
    ],
    "family": [
      {
        "curp": "GOTL120418HDFMRS00",
        "firstSurname": "GOMEZ",
        "secondSurname": "TORRES",
        "givenNames": "LUIS",
        "relationship": "HIJO",
        "status": "ACTIVO",
        "dateOfBirth": "2012-04-18",
        "registrationDate": "2012-05-01"
      },
      {
        "curp": "RASP840912HDFMLD05",
        "firstSurname": "RAMIREZ",
        "secondSurname": "SOLIS",
        "givenNames": "PEDRO",
        "relationship": "ESPOSO",
        "status": "ACTIVO",
        "dateOfBirth": "1984-09-12",
        "registrationDate": "2010-02-01"
      }
    ],
    "address": {
      "street": "AVENIDA EJEMPLO",
      "exteriorNumber": "100",
      "interiorNumber": null,
      "neighborhood": "CENTRO",
      "municipality": "PUEBLA",
      "state": "PUEBLA",
      "postalCode": "00000"
    },
    "clinic": {
      "code": "3620300",
      "type": "HAE",
      "name": "PUEBLA, PUE.",
      "address": "JARDINES DE SAN MANUEL, JARDINES DE SAN MANUEL",
      "issteDelegation": "DELEGACION ESTATAL EN PUEBLA",
      "phone": "2222456950"
    },
    "files": [
      {
        "kind": "document",
        "contentType": "application/pdf",
        "sizeBytes": 207341,
        "content": "JVBERi0xLjYKJdP0...TRUNCATED_BASE64..."
      },
      {
        "kind": "face",
        "contentType": "image/jpeg",
        "sizeBytes": 8421,
        "content": "/9j/4AAQSkZJRgABAQEAYABgAAD...TRUNCATED_BASE64.../9k="
      }
    ]
  },
  "transactionId": "c1d2e3f4-a5b6-7c8d-9e0f-success00000",
  "processedAt": "2026-06-02T10:00:00-06:00",
  "billable": true
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
curp
string
required

CURP of the government worker whose ISSSTE record is requested.

Example:

"GOTM850312MDFMRX05"

Response

ISSSTE record result (Strict Envelope Pattern).

​
status
enum<string>
required

High-level outcome. OK means the request was successfully processed (regardless of business result). ERROR means the request was rejected or could not be processed.

Available options:
OK,
ERROR
​
type
string
required

Stable result type code. Includes generic codes (SUCCESS, INVALID_REQUEST, UNAUTHORIZED, SERVICE_UNAVAILABLE, INTERNAL_ERROR, RATE_LIMIT_EXCEEDED) plus endpoint-specific result codes — see this endpoint's response examples.

​
message
string
required

Human-readable summary of the result. Always in English (per Language Conventions in the API overview).

​
transactionId
string<uuid>
required

Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.

​
processedAt
string<date-time>
required

ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.

​
billable
boolean
required

Whether this request will be charged against the client's plan. Typically true for successful business results and false for validation errors or system errors that prevented processing.

​
data
object

Full ISSSTE record for a government worker. Present only when type is SUCCESS.

​
errors
object[]

Per-field error details. Present only on INVALID_REQUEST responses.