1. Check
ImmigraFlow API
  • Check
    • Check case status
      POST
  • Users
    • Verify email token
      POST
    • List users
      GET
    • Create user
      POST
    • Get user
      GET
    • Update user
      PUT
  • Cases
    • List user cases
      GET
    • Create case
      POST
    • Get one case
      GET
    • Update case
      PUT
  • Webhooks
    • List webhooks
      GET
    • Create webhook
      POST
    • Get webhook
      GET
    • Update webhook
      PUT
    • Delete webhook
      DELETE
  • Schemas
    • ErrorEnvelope
    • CheckRequest
    • User
    • UserCreateRequest
    • UserUpdateRequest
    • CaseSummary
    • CaseCreateRequest
    • CaseUpdateRequest
    • StatusUpdate
    • CaseDetailsResponse
    • CheckResponse
    • Webhook
    • WebhookCreateRequest
    • WebhookUpdateRequest
  1. Check

Check case status

POST
/v1/check
Finds a case by user email + receipt number under the authenticated partner.
If not found in local DB, attempts USCIS lookup fallback.

Request

Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
API Key
Add parameter in header
X-API-SECRET
Example:
X-API-SECRET: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Case status retrieved
Body

🟠400BadRequest
🟠401Unauthorized
🟠404NotFound
🔴500InternalError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://devapi.immigraflow.com/v1/check' \
--header 'X-API-KEY: <api-key>' \
--header 'X-API-SECRET: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "user@example.com",
    "receipt_number": "string"
}'
Response Response Example
200 - Success
{
    "success": true,
    "case": {
        "receipt_number": "LIN9999106501",
        "description": "Case retrieved from USCIS",
        "created_at": "2026-04-20 16:34:36",
        "user_case_id": "EXTERNAL",
        "name": "USCIS Case",
        "registered_by": "USCIS API"
    },
    "status_updates": [
        {
            "status_code": "Case Was Received",
            "status_description": "On September 5, 2023, we received your Form I-130, Petition for Alien Relative, Receipt Number LIN9999106501, and sent you the receipt notice that describes how we will process your case. Please follow the instructions in the notice. If you have any questions, visit the USCIS Contact Center webpage at <a href=\"https://www.uscis.gov/contactcenter\" target=\"_blank\">www.uscis.gov/contactcenter</a>. If you move, go to <a href=\"https://www.uscis.gov/addresschange\" target=\"_blank\">www.uscis.gov/addresschange</a> to give us your new mailing address.",
            "form_type": "I-130",
            "detail_message": "",
            "status_code_es": "Caso Recibido",
            "status_description_es": "El 05 de Septiembre de 2023, recibimos su Formulario I-130, Petición de Familiar Extranjero, número de recibo LIN9999106501, y le enviamos la notificación de recibo que describe cómo procesaremos su caso. Siga las instrucciones de la notificación. Si tiene alguna pregunta, visite la página web del Centro de Contacto de USCIS en <a href=\"https://www.uscis.gov/es/centrocontacto\" target=\"_blank\">www.uscis.gov/es/centrocontacto</a>. Si cambia de domicilio, visite <a href=\"https://www.uscis.gov/es/cambiodedireccion\" target=\"_blank\">www.uscis.gov/es/cambiodedireccion</a> para notificarnos su nueva dirección postal.",
            "status_code_pt": "",
            "status_description_pt": "",
            "submitted_date": "09-05-2023 14:28:47",
            "modified_date": "09-05-2023 14:28:47",
            "timestamp": "2026-04-20 16:34:35",
            "notified": 0,
            "history": []
        }
    ],
    "update_count": 1,
    "source": "USCIS API"
}
Modified at 2026-04-20 16:34:45
Next
Verify email token
Built with