Social Security

Employment Status

Credits: 1 per call.

Returns the current IMSS employment status of a worker (identified by CURP + NSS): whether they are currently registered as employed, inactive (no current registration), the modality of registration, the registered employer’s RFC, employer name, state, base salary, contributed days, and the period the IMSS report covers.

Use this endpoint for income verification (lending, leasing), employment confirmation (background checks), or to detect overlapping employment when complying with employment regulations.

cURL

curl -X POST https://api.origoid.com/mex/social-security/v1/imss-employment-status \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"curp": "GARM900101HDFRZA01", "nss": "92038109713"}'

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Active employment found",
  "data": {
    "nss": "92038109713",
    "personalInfo": {
      "curp": "GARM900101HDFRZA01",
      "givenNames": "SANTIAGO FORTINO",
      "firstSurname": "ESPINOZA",
      "secondSurname": "SANCHEZ",
      "gender": "H"
    },
    "employmentInformation": [
      {
        "employerRegistration": "Y5473416",
        "modality": "10",
        "employerRfc": "FDM020722442",
        "employerName": "LOGISTICA GLOBAL DE MEXICO S DE RL DE CV",
        "state": "CIUDAD DE MEXICO",
        "stateCode": "09",
        "baseSalary": {
          "amount": "2932.75",
          "currency": "MXN"
        },
        "contributedDays": 28
      }
    ],
    "reportDetails": {
      "reportPeriod": "2026-02",
      "issueDate": "2026-03-15"
    }
  },
  "transactionId": "26aca817-9a02-4119-bc06-2fcab3666454",
  "processedAt": "2026-03-15T19:24:00-06:00",
  "billable": true
}

Autorizaciones

x-api-key

string

header

requerido

Cuerpo

application/json

curp

string

requerido

Ejemplo:

"GARM900101HDFRZA01"

nss

string

requerido

Ejemplo:

"92038109713"

Respuesta

Business Responses (Strict Envelope Pattern).

status

enum<string>

requerido

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.

Opciones disponibles:

OK,

ERROR

type

string

requerido

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

requerido

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

transactionId

string<uuid>

requerido

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

processedAt

string<date-time>

requerido

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

billable

boolean

requerido

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

Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.

errors

object[]

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

Show child attributes

ISSSTE Record**Credits:** 1 per call. Retrieves a government worker's full ISSSTE record by CURP — personal data, affiliation, pension regime, positions, contribution history, address, assigned clinic, and the official PDF (always included as base64 in `data.files[]` (kind `document`)). A retrieved record returns `type: SUCCESS` for an active worker. `PENSIONER`, `SCHOLAR`, `INACTIVE`, and `DECEASED` flag KYC-material standings; when more than one applies, precedence is `DECEASED` > `PENSIONER`/`SCHOLAR` > `INACTIVE`. The raw affiliation status and beneficiary type are always in `data.affiliation`, so new statuses ISSSTE may report never break the contract. `CURP_NOT_FOUND` when the CURP has no ISSSTE record. Dates are ISO `YYYY-MM-DD`; monetary amounts are strings (MXN). **Field presence:** every field is always present (stable contract) — absent values are `null` (objects/scalars, including empty source strings normalized to `null`) or `[]` (arrays), never omitted. Examples: `pensions` and `family` are `[]` when the worker has none; `terminationDate` and a history row's `endDate` are `null` while ongoing; binary assets in `data.files[]` follow array semantics — only assets actually produced are listed (absent ones omitted, not `null`). Unmigrated placeholder values from ISSSTE (e.g. address `POR ACTUALIZAR`, clinic `FAVOR DE ATENDER A ESTE TRABAJADOR` / clave `0409999`, state `ENTIDAD DESCONOCIDA`) are normalized to `null` (data not yet migrated). ISSSTE only exposes records for titulares (TRABAJADOR/PENSIONISTA/BECARIO); a CURP that is only a dependant (not a titular) returns `CURP_NOT_FOUND`. To retrieve a dependant, query the titular CURP and match `data.family[]` by the dependant CURP. `beneficiaryType` is derived authoritatively from the record (a DIRECT pension means PENSIONISTA even if the document labels them TRABAJADOR); each pension carries a derived `category` (DIRECT/SURVIVOR/INSURANCE/DISABILITY).

cURL

curl -X POST https://api.origoid.com/mex/social-security/v1/imss-employment-status \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"curp": "GARM900101HDFRZA01", "nss": "92038109713"}'

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Active employment found",
  "data": {
    "nss": "92038109713",
    "personalInfo": {
      "curp": "GARM900101HDFRZA01",
      "givenNames": "SANTIAGO FORTINO",
      "firstSurname": "ESPINOZA",
      "secondSurname": "SANCHEZ",
      "gender": "H"
    },
    "employmentInformation": [
      {
        "employerRegistration": "Y5473416",
        "modality": "10",
        "employerRfc": "FDM020722442",
        "employerName": "LOGISTICA GLOBAL DE MEXICO S DE RL DE CV",
        "state": "CIUDAD DE MEXICO",
        "stateCode": "09",
        "baseSalary": {
          "amount": "2932.75",
          "currency": "MXN"
        },
        "contributedDays": 28
      }
    ],
    "reportDetails": {
      "reportPeriod": "2026-02",
      "issueDate": "2026-03-15"
    }
  },
  "transactionId": "26aca817-9a02-4119-bc06-2fcab3666454",
  "processedAt": "2026-03-15T19:24:00-06:00",
  "billable": true
}