Social Security

Employment Status (Async)

Credits: 2 per resolved request — charged when the result resolves; the ACCEPTED acknowledgement is free. includePdf adds no extra credits.

Asynchronous version of Employment Status: returns the current IMSS employment status of a worker identified by CURP and delivers the result to your webhook instead of keeping the HTTP request open.

nss is optional: when you send it, it is checked against the NSS registered for the CURP and a difference returns MISMATCH_CURP_NSS. Set includePdf: true to also receive the official IMSS report as a PDF in data.files[].

Immediate response: ACCEPTED with the transactionId, or INVALID_REQUEST if the request is not valid.

Result: delivered to your webhook with the same result types and data as Employment Status (except INVALID_REQUEST, which is returned immediately). Every result type, with its example, is in the Webhooks guide.

cURL

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

const response = await fetch("https://api.origoid.com/mex/social-security/v1/imss-employment-status-async", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ORIGOID_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "curp": "GARM900101HDFRZA01",
    "nss": "92038109713",
    "includePdf": true,
    "webhook": {
      "url": "https://your-domain.com/hooks/origoid"
    }
  }),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const result = await response.json();
console.log(result);

import os
import requests

response = requests.post(
    "https://api.origoid.com/mex/social-security/v1/imss-employment-status-async",
    headers={
        "x-api-key": os.environ["ORIGOID_API_KEY"],
        "content-type": "application/json",
    },
    json={
        "curp": "GARM900101HDFRZA01",
        "nss": "92038109713",
        "includePdf": True,
        "webhook": {
            "url": "https://your-domain.com/hooks/origoid"
        }
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()
print(result)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Example {
    public static void main(String[] args) throws Exception {
        String payload = "{\"curp\": \"GARM900101HDFRZA01\", \"nss\": \"92038109713\", \"includePdf\": true, \"webhook\": {\"url\": \"https://your-domain.com/hooks/origoid\"}}";

        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.origoid.com/mex/social-security/v1/imss-employment-status-async"))
            .header("x-api-key", System.getenv("ORIGOID_API_KEY"))
            .header("content-type", "application/json")
            .timeout(Duration.ofSeconds(30))
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

<?php
$payload = '{"curp": "GARM900101HDFRZA01", "nss": "92038109713", "includePdf": true, "webhook": {"url": "https://your-domain.com/hooks/origoid"}}';

$ch = curl_init('https://api.origoid.com/mex/social-security/v1/imss-employment-status-async');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . getenv('ORIGOID_API_KEY'),
        'content-type: application/json',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception("HTTP $status");
}

$result = json_decode($response, true);
print_r($result);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"
	"time"
)

func main() {
	payload := []byte(`{"curp": "GARM900101HDFRZA01", "nss": "92038109713", "includePdf": true, "webhook": {"url": "https://your-domain.com/hooks/origoid"}}`)
	req, err := http.NewRequest("POST", "https://api.origoid.com/mex/social-security/v1/imss-employment-status-async", bytes.NewBuffer(payload))
	if err != nil { log.Fatal(err) }
	req.Header.Set("x-api-key", os.Getenv("ORIGOID_API_KEY"))
	req.Header.Set("content-type", "application/json")

	client := &http.Client{Timeout: 30 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()

	var result map[string]any
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		log.Fatal(err)
	}
	fmt.Println(result)
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
        client.DefaultRequestHeaders.Add("x-api-key",
            Environment.GetEnvironmentVariable("ORIGOID_API_KEY"));

        var payload = "{\"curp\": \"GARM900101HDFRZA01\", \"nss\": \"92038109713\", \"includePdf\": true, \"webhook\": {\"url\": \"https://your-domain.com/hooks/origoid\"}}";
        var content = new StringContent(payload, Encoding.UTF8, "application/json");

        var response = await client.PostAsync("https://api.origoid.com/mex/social-security/v1/imss-employment-status-async", content);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

{
  "status": "OK",
  "type": "ACCEPTED",
  "message": "Request accepted, result will be sent to the webhook",
  "data": null,
  "transactionId": "322e6c8b-0124-5c84-95db-4da04842d0da",
  "processedAt": "2026-03-15T19:23:30-06:00",
  "billable": false
}

Authorizations

x-api-key

string

header

required

Body

application/json

curp

string

required

18-character CURP.

Example:

"GARM900101HDFRZA01"

webhook

object

required

Where the result of an asynchronous request is delivered (HTTP POST with a JSON body).

Show child attributes

nss

string

Optional 11-digit NSS, checked against the NSS registered for the CURP.

Pattern: ^\d{11}$

Example:

"92038109713"

includePdf

boolean

default:false

Also return the official IMSS report as a PDF in data.files[]. No extra credits.

Response

Immediate response (Strict Envelope Pattern). The result is delivered to your webhook.

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 | null

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

cURL

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

const response = await fetch("https://api.origoid.com/mex/social-security/v1/imss-employment-status-async", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ORIGOID_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "curp": "GARM900101HDFRZA01",
    "nss": "92038109713",
    "includePdf": true,
    "webhook": {
      "url": "https://your-domain.com/hooks/origoid"
    }
  }),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const result = await response.json();
console.log(result);

import os
import requests

response = requests.post(
    "https://api.origoid.com/mex/social-security/v1/imss-employment-status-async",
    headers={
        "x-api-key": os.environ["ORIGOID_API_KEY"],
        "content-type": "application/json",
    },
    json={
        "curp": "GARM900101HDFRZA01",
        "nss": "92038109713",
        "includePdf": True,
        "webhook": {
            "url": "https://your-domain.com/hooks/origoid"
        }
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()
print(result)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Example {
    public static void main(String[] args) throws Exception {
        String payload = "{\"curp\": \"GARM900101HDFRZA01\", \"nss\": \"92038109713\", \"includePdf\": true, \"webhook\": {\"url\": \"https://your-domain.com/hooks/origoid\"}}";

        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.origoid.com/mex/social-security/v1/imss-employment-status-async"))
            .header("x-api-key", System.getenv("ORIGOID_API_KEY"))
            .header("content-type", "application/json")
            .timeout(Duration.ofSeconds(30))
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(
            request, HttpResponse.BodyHandlers.ofString()
        );

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

<?php
$payload = '{"curp": "GARM900101HDFRZA01", "nss": "92038109713", "includePdf": true, "webhook": {"url": "https://your-domain.com/hooks/origoid"}}';

$ch = curl_init('https://api.origoid.com/mex/social-security/v1/imss-employment-status-async');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . getenv('ORIGOID_API_KEY'),
        'content-type: application/json',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception("HTTP $status");
}

$result = json_decode($response, true);
print_r($result);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"
	"time"
)

func main() {
	payload := []byte(`{"curp": "GARM900101HDFRZA01", "nss": "92038109713", "includePdf": true, "webhook": {"url": "https://your-domain.com/hooks/origoid"}}`)
	req, err := http.NewRequest("POST", "https://api.origoid.com/mex/social-security/v1/imss-employment-status-async", bytes.NewBuffer(payload))
	if err != nil { log.Fatal(err) }
	req.Header.Set("x-api-key", os.Getenv("ORIGOID_API_KEY"))
	req.Header.Set("content-type", "application/json")

	client := &http.Client{Timeout: 30 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()

	var result map[string]any
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		log.Fatal(err)
	}
	fmt.Println(result)
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
        client.DefaultRequestHeaders.Add("x-api-key",
            Environment.GetEnvironmentVariable("ORIGOID_API_KEY"));

        var payload = "{\"curp\": \"GARM900101HDFRZA01\", \"nss\": \"92038109713\", \"includePdf\": true, \"webhook\": {\"url\": \"https://your-domain.com/hooks/origoid\"}}";
        var content = new StringContent(payload, Encoding.UTF8, "application/json");

        var response = await client.PostAsync("https://api.origoid.com/mex/social-security/v1/imss-employment-status-async", content);
        response.EnsureSuccessStatusCode();

        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine(body);
    }
}

{
  "status": "OK",
  "type": "ACCEPTED",
  "message": "Request accepted, result will be sent to the webhook",
  "data": null,
  "transactionId": "322e6c8b-0124-5c84-95db-4da04842d0da",
  "processedAt": "2026-03-15T19:23:30-06:00",
  "billable": false
}

Authentication

RENAPO

Social Security

INE

Biometrics

Compliance

Email

Proof of Address

Fiscal

Banking

Employment Status (Async)

Authorizations

Body

Response