Social Security
Contribution Weeks Result
Credits: 0 (free).
Fallback to fetch the result of a Contribution Weeks request when your webhook could not receive it. Results are available for 24 hours after the request resolved. The result is always sent to your webhook, so use this endpoint only as a fallback, not to poll.
Send the transactionId returned by Contribution Weeks:
RESULT_FOUND:datacontains the original result envelope, exactly as delivered to the webhook, with its owntransactionId(the one that was charged). The outer envelope describes this free query.RESULT_PENDING: the request is still being processed; the result will be sent to your webhook.RESULT_EXPIRED: more than 24 hours have passed; the result is no longer available.INVALID_REQUEST: thetransactionIddoes not exist or belongs to another client (both answer the same way).
cURL
curl -X POST https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"}'const response = await fetch("https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results", {
method: "POST",
headers: {
"x-api-key": process.env.ORIGOID_API_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"
}),
});
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-contribution-weeks-results",
headers={
"x-api-key": os.environ["ORIGOID_API_KEY"],
"content-type": "application/json",
},
json={
"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"
},
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 = "{\"transactionId\": \"975cf12f-f270-51cc-9037-d710134940c9\"}";
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-contribution-weeks-results"))
.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 = '{"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"}';
$ch = curl_init('https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results');
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(`{"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"}`)
req, err := http.NewRequest("POST", "https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results", 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 = "{\"transactionId\": \"975cf12f-f270-51cc-9037-d710134940c9\"}";
var content = new StringContent(payload, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results", content);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}
}{
"status": "OK",
"type": "RESULT_FOUND",
"message": "Result found",
"data": {
"status": "OK",
"type": "SUCCESS",
"message": "Active employment found",
"data": {
"nss": "45028712309",
"personalInfo": {
"curp": "RATL850312HDFMRS07",
"givenNames": "LUIS ALBERTO",
"firstSurname": "RAMIREZ",
"secondSurname": "TORRES",
"gender": "H",
"dateOfBirth": "1985-03-12"
},
"contributionWeeks": {
"total": 612,
"contributed": 612,
"discounted": 0,
"reinstated": 0
},
"derivedSignals": {
"currentStatus": {
"employed": true,
"monthsInCurrentStatus": 60,
"lastDailySalary": {
"amount": "685.50",
"currency": "MXN"
},
"lastMonthlySalary": {
"amount": "20866.62",
"currency": "MXN"
},
"salaryAtLegalCap": false
},
"jobTenure": {
"currentJobMonths": 60,
"averageJobMonths": 42,
"longestJobMonths": 60,
"shortestJobMonths": 4.5,
"monthsSinceFirstJob": 210
},
"stability": {
"employerCount": 4,
"distinctEmployerCount": 4,
"monthsPerEmployer": 52.5,
"jobChanges": 3,
"jobChangesLast5Years": 1,
"simultaneousJobsDetected": 0,
"unemploymentPeriods": {
"count": 3,
"totalMonths": 22,
"longestMonths": 11.5,
"monthsSinceLastUnemployment": 60
},
"monthsActuallyEmployed": 188,
"percentOfTimeEmployed": 89.5
},
"salary": {
"first": {
"amount": "210.00",
"currency": "MXN"
},
"latest": {
"amount": "685.50",
"currency": "MXN"
},
"highest": {
"amount": "685.50",
"currency": "MXN"
},
"lowest": {
"amount": "210.00",
"currency": "MXN"
},
"changePercentFirstToLatest": 226.4,
"firstMonthly": {
"amount": "6392.40",
"currency": "MXN"
},
"latestMonthly": {
"amount": "20866.62",
"currency": "MXN"
},
"employerChanges": {
"withRaise": 3,
"withCut": 0
},
"snapshots": {
"oneYearAgo": {
"dailySalary": {
"amount": "685.50",
"currency": "MXN"
},
"monthlySalary": {
"amount": "20866.62",
"currency": "MXN"
},
"changePercentToLatest": 0
},
"threeYearsAgo": {
"dailySalary": {
"amount": "620.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "18872.80",
"currency": "MXN"
},
"changePercentToLatest": 10.6
},
"fiveYearsAgo": {
"dailySalary": {
"amount": "480.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "14611.20",
"currency": "MXN"
},
"changePercentToLatest": 42.8
}
}
},
"salaryTimeline": [
{
"event": "HIRED",
"date": "2009-02-10",
"employerName": "ABARROTES EL SURTIDOR",
"dailySalary": {
"amount": "210.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "6392.40",
"currency": "MXN"
}
},
{
"event": "TERMINATED",
"date": "2009-06-28",
"employerName": "ABARROTES EL SURTIDOR",
"dailySalary": {
"amount": "210.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "6392.40",
"currency": "MXN"
}
},
{
"event": "HIRED",
"date": "2021-08-16",
"employerName": "SERVICIOS INTEGRALES DEL NORTE SA DE CV",
"dailySalary": {
"amount": "685.50",
"currency": "MXN"
},
"monthlySalary": {
"amount": "20866.62",
"currency": "MXN"
}
}
]
},
"employmentHistory": [
{
"employerName": "SERVICIOS INTEGRALES DEL NORTE SA DE CV",
"employerRegistration": "A5512340987",
"state": "CIUDAD DE MÉXICO",
"startDate": "2021-08-16",
"endDate": null,
"baseSalary": {
"amount": "685.50",
"currency": "MXN"
}
},
{
"employerName": "DISTRIBUIDORA GAMMA SA DE CV",
"employerRegistration": "B7788990011",
"state": "JALISCO",
"startDate": "2016-05-02",
"endDate": "2021-06-30",
"baseSalary": {
"amount": "540.00",
"currency": "MXN"
}
},
{
"employerName": "ABARROTES EL SURTIDOR",
"employerRegistration": "C4433221100",
"state": "JALISCO",
"startDate": "2009-02-10",
"endDate": "2009-06-28",
"baseSalary": {
"amount": "210.00",
"currency": "MXN"
}
}
],
"reportDetails": {
"source": "IMSS",
"documentType": "CONSTANCIA DE SEMANAS COTIZADAS",
"folio": "20481135900274651093824",
"issueDate": "2026-08-12",
"serialNumber": "00000000000000004821",
"notarialSequence": "b28f4c19-6a03-41e2-9c15-7dd0a2e51b47",
"digitalSeal": "Qm9ndXNTZWFsRXhhbXBsZURhdGFOb3RSZWFsRm9yRG9jdW1lbnRhdGlvbk9ubHk9PQ=="
},
"files": [
{
"kind": "document",
"contentType": "application/pdf",
"sizeBytes": 73412,
"content": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3Ro..."
}
]
},
"transactionId": "975cf12f-f270-51cc-9037-d710134940c9",
"processedAt": "2026-08-13T11:20:00-06:00",
"billable": true
},
"transactionId": "c87b960c-1d21-5a39-ac95-c68e05023ee1",
"processedAt": "2026-08-13T11:35:00-06:00",
"billable": false
}Authorizations
ApiKeyAuthBearerAuthBasicAuth
Body
application/json
The transactionId returned by Contribution Weeks.
Example:
"975cf12f-f270-51cc-9037-d710134940c9"
Response
Business Responses (Strict Envelope Pattern).
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 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.
Human-readable summary of the result. Always in English (per Language Conventions in the API overview).
Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.
ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.
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.
Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.
Per-field error details. Present only on INVALID_REQUEST responses.
Show child attributes
Show child attributes
⌘I
cURL
curl -X POST https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"}'const response = await fetch("https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results", {
method: "POST",
headers: {
"x-api-key": process.env.ORIGOID_API_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"
}),
});
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-contribution-weeks-results",
headers={
"x-api-key": os.environ["ORIGOID_API_KEY"],
"content-type": "application/json",
},
json={
"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"
},
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 = "{\"transactionId\": \"975cf12f-f270-51cc-9037-d710134940c9\"}";
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-contribution-weeks-results"))
.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 = '{"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"}';
$ch = curl_init('https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results');
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(`{"transactionId": "975cf12f-f270-51cc-9037-d710134940c9"}`)
req, err := http.NewRequest("POST", "https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results", 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 = "{\"transactionId\": \"975cf12f-f270-51cc-9037-d710134940c9\"}";
var content = new StringContent(payload, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.origoid.com/mex/social-security/v1/imss-contribution-weeks-results", content);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}
}{
"status": "OK",
"type": "RESULT_FOUND",
"message": "Result found",
"data": {
"status": "OK",
"type": "SUCCESS",
"message": "Active employment found",
"data": {
"nss": "45028712309",
"personalInfo": {
"curp": "RATL850312HDFMRS07",
"givenNames": "LUIS ALBERTO",
"firstSurname": "RAMIREZ",
"secondSurname": "TORRES",
"gender": "H",
"dateOfBirth": "1985-03-12"
},
"contributionWeeks": {
"total": 612,
"contributed": 612,
"discounted": 0,
"reinstated": 0
},
"derivedSignals": {
"currentStatus": {
"employed": true,
"monthsInCurrentStatus": 60,
"lastDailySalary": {
"amount": "685.50",
"currency": "MXN"
},
"lastMonthlySalary": {
"amount": "20866.62",
"currency": "MXN"
},
"salaryAtLegalCap": false
},
"jobTenure": {
"currentJobMonths": 60,
"averageJobMonths": 42,
"longestJobMonths": 60,
"shortestJobMonths": 4.5,
"monthsSinceFirstJob": 210
},
"stability": {
"employerCount": 4,
"distinctEmployerCount": 4,
"monthsPerEmployer": 52.5,
"jobChanges": 3,
"jobChangesLast5Years": 1,
"simultaneousJobsDetected": 0,
"unemploymentPeriods": {
"count": 3,
"totalMonths": 22,
"longestMonths": 11.5,
"monthsSinceLastUnemployment": 60
},
"monthsActuallyEmployed": 188,
"percentOfTimeEmployed": 89.5
},
"salary": {
"first": {
"amount": "210.00",
"currency": "MXN"
},
"latest": {
"amount": "685.50",
"currency": "MXN"
},
"highest": {
"amount": "685.50",
"currency": "MXN"
},
"lowest": {
"amount": "210.00",
"currency": "MXN"
},
"changePercentFirstToLatest": 226.4,
"firstMonthly": {
"amount": "6392.40",
"currency": "MXN"
},
"latestMonthly": {
"amount": "20866.62",
"currency": "MXN"
},
"employerChanges": {
"withRaise": 3,
"withCut": 0
},
"snapshots": {
"oneYearAgo": {
"dailySalary": {
"amount": "685.50",
"currency": "MXN"
},
"monthlySalary": {
"amount": "20866.62",
"currency": "MXN"
},
"changePercentToLatest": 0
},
"threeYearsAgo": {
"dailySalary": {
"amount": "620.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "18872.80",
"currency": "MXN"
},
"changePercentToLatest": 10.6
},
"fiveYearsAgo": {
"dailySalary": {
"amount": "480.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "14611.20",
"currency": "MXN"
},
"changePercentToLatest": 42.8
}
}
},
"salaryTimeline": [
{
"event": "HIRED",
"date": "2009-02-10",
"employerName": "ABARROTES EL SURTIDOR",
"dailySalary": {
"amount": "210.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "6392.40",
"currency": "MXN"
}
},
{
"event": "TERMINATED",
"date": "2009-06-28",
"employerName": "ABARROTES EL SURTIDOR",
"dailySalary": {
"amount": "210.00",
"currency": "MXN"
},
"monthlySalary": {
"amount": "6392.40",
"currency": "MXN"
}
},
{
"event": "HIRED",
"date": "2021-08-16",
"employerName": "SERVICIOS INTEGRALES DEL NORTE SA DE CV",
"dailySalary": {
"amount": "685.50",
"currency": "MXN"
},
"monthlySalary": {
"amount": "20866.62",
"currency": "MXN"
}
}
]
},
"employmentHistory": [
{
"employerName": "SERVICIOS INTEGRALES DEL NORTE SA DE CV",
"employerRegistration": "A5512340987",
"state": "CIUDAD DE MÉXICO",
"startDate": "2021-08-16",
"endDate": null,
"baseSalary": {
"amount": "685.50",
"currency": "MXN"
}
},
{
"employerName": "DISTRIBUIDORA GAMMA SA DE CV",
"employerRegistration": "B7788990011",
"state": "JALISCO",
"startDate": "2016-05-02",
"endDate": "2021-06-30",
"baseSalary": {
"amount": "540.00",
"currency": "MXN"
}
},
{
"employerName": "ABARROTES EL SURTIDOR",
"employerRegistration": "C4433221100",
"state": "JALISCO",
"startDate": "2009-02-10",
"endDate": "2009-06-28",
"baseSalary": {
"amount": "210.00",
"currency": "MXN"
}
}
],
"reportDetails": {
"source": "IMSS",
"documentType": "CONSTANCIA DE SEMANAS COTIZADAS",
"folio": "20481135900274651093824",
"issueDate": "2026-08-12",
"serialNumber": "00000000000000004821",
"notarialSequence": "b28f4c19-6a03-41e2-9c15-7dd0a2e51b47",
"digitalSeal": "Qm9ndXNTZWFsRXhhbXBsZURhdGFOb3RSZWFsRm9yRG9jdW1lbnRhdGlvbk9ubHk9PQ=="
},
"files": [
{
"kind": "document",
"contentType": "application/pdf",
"sizeBytes": 73412,
"content": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3Ro..."
}
]
},
"transactionId": "975cf12f-f270-51cc-9037-d710134940c9",
"processedAt": "2026-08-13T11:20:00-06:00",
"billable": true
},
"transactionId": "c87b960c-1d21-5a39-ac95-c68e05023ee1",
"processedAt": "2026-08-13T11:35:00-06:00",
"billable": false
}