Skip to main content
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
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
curp
string
required
Example:

"GARM900101HDFRZA01"

​
nss
string
required
Example:

"92038109713"

Response

Business Responses (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

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.