Open API

Build with CheckCaseStatus API

Integrate USCIS case status checking and AI analysis into your application, chatbot, or workflow. RESTful API with OpenAPI 3.0 spec and MCP protocol support.

RESTful API MCP Protocol EN / ZH / ES API Key Auth

Quick Start

Make your first API call in seconds. Just add your API key to the header.

curl -H "X-API-Key: YOUR_API_KEY" \
  https://checkcasestatus.com/api/v1/case/EAC2390000001

Response example:

{
  "receiptNumber": "EAC2390000001",
  "status": "Case Was Received",
  "description": "On January 15, 2023, we received your Form I-485...",
  "formType": "I-485",
  "lastCheck": "2026-02-18T10:30:00Z",
  "history": [
    { "date": "2023-01-15", "text": "We received your Form I-485..." },
    { "date": "2023-02-10", "text": "We sent you a receipt notice..." }
  ]
}

Authentication

All API requests require authentication. Two methods are supported:

API Key

Include your API key in the X-API-Key header. Recommended for server-to-server integrations.

X-API-Key: YOUR_API_KEY

Bearer Token

Use a PocketBase auth token in the Authorization header. Suitable for authenticated user sessions.

Authorization: Bearer YOUR_TOKEN

Rate Limits

API requests are limited to 20 requests per minute per API key. If you exceed the limit, you'll receive a 429 status code. Contact us for higher limits.

API Endpoints

GET/api/v1/case/{receipt}

Check Case Status

Query the current status of a USCIS immigration case. Returns status, description, form type, and full history timeline.

Parameter	In	Type	Required	Description
receipt	path	string	required	USCIS receipt number (3 letters + 10 digits, e.g., EAC2390000001)

POST/api/v1/case/{receipt}/analyze

AI Case Analysis

AI-powered deep analysis including status interpretation, timeline prediction, recommended next steps. Supports en/zh/es.

Parameter	In	Type	Required	Description
receipt	path	string	required	USCIS receipt number
locale	body	string	optional	Language: en \| zh \| es (default: en)

POST/api/v1/chat

Chat with AI Agent

Send a natural language message to the USCIS AI agent. The agent can check cases, analyze status, and answer immigration questions.

Parameter	In	Type	Required	Description
message	body	string	required	User's message or question
locale	body	string	optional	Language: en \| zh \| es (default: en)

Integration Guides

Step-by-step guides for connecting CheckCaseStatus to popular AI platforms.

ChatGPT GPTs Actions

Create a custom GPT that can check USCIS case status directly in ChatGPT conversations.

1Go to chatgpt.com/gpts/editor and create a new GPT.
2In Configure → Actions, click "Create new action" → "Import from URL".
3Enter the OpenAPI spec URL and configure API Key authentication (Header: X-API-Key).
4Add the system prompt below and publish your GPT.

# Import OpenAPI spec URL in GPT Actions:
https://checkcasestatus.com/api/v1/openapi.json

# Authentication: API Key
Header name: X-API-Key
Value: YOUR_API_KEY

Recommended system prompt for your GPT:

You are a USCIS immigration case assistant. When a user provides a receipt number (format: 3 letters + 10 digits, e.g., EAC2390000001), use the checkCaseStatus action to query it. For detailed analysis, use analyzeCase. Always respond in the user's language.

Error Codes

Code	Meaning	Action
200	Success	Request completed successfully
400	Bad Request	Check receipt number format (3 letters + 10 digits)
401	Unauthorized	Verify your API key or auth token
403	Forbidden	This feature requires a Pro membership
429	Too Many Requests	Wait and retry. Max 20 requests/min per key
503	Service Unavailable	USCIS API is temporarily down. Retry later

FAQ

How do I get an API key?

Is the data from the official USCIS API?

Yes. All case status data is sourced from the official USCIS Torch API with intelligent caching to reduce latency.

What languages are supported?

The API supports English (en), Chinese (zh), and Spanish (es). Pass the locale parameter to get localized AI analysis.

Can I use this for commercial purposes?

Yes. Our API is designed for integration into commercial products and services. Contact us for enterprise pricing.

USCIS API Compliance

Non-Affiliation Disclaimer

CheckCaseStatus.com is NOT affiliated with, endorsed by, or connected to DHS, USCIS, or any U.S. government agency. If you integrate our API, you must display a similar disclaimer in your application.

When building applications using our API, you must adhere to the following requirements per the USCIS API Terms of Use:

All API keys and tokens must be stored securely on your server infrastructure. Never expose credentials in client-side code.
Your application must properly handle all HTTPS response codes, including error responses per RFC 9457.
You must not use government seals, insignia, or visual identities (DHS, USCIS, etc.) in your application per 18 U.S.C. §§ 506, 701, 1017.
You must have a public Privacy Policy and Terms of Service that comply with CCPA and USCIS requirements.
USCIS API data must not be sold, redistributed, or used for advertising targeting.
Your application must meet Section 508 accessibility standards and WCAG 2.1 Level AA contrast requirements (minimum 4.5:1).

Ready to Integrate?

Start building with our API today. Full OpenAPI spec available for instant import.

Questions? Email support@checkcasestatus.com