US Citizenship and Immigration Services · OAuth Scopes

US Citizenship and Immigration Services OAuth Scopes

OAuth 2.0 derived

US Citizenship and Immigration Services publishes 3 OAuth 2.0 scopes via the clientCredentials flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the US Citizenship and Immigration Services API on a user’s behalf.

Tokens are issued from https://api-int.uscis.gov/oauth/accesstoken.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

Federal GovernmentImmigrationCitizenshipCase StatusFOIA

Scopes: 3 Flows: clientCredentials Method: derived

OAuth endpoints

Token URL
https://api-int.uscis.gov/oauth/accesstoken

Flows
clientCredentials

Scopes (3)

Scope	Description	Flows
read:case-status	Read immigration case status information	clientCredentials
read:foia-requests	Read FOIA request status	clientCredentials
write:foia-requests	Submit FOIA requests	clientCredentials

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/uscis-case-status-api-openapi.yml, openapi/uscis-foia-api-openapi.yml
schemes:
- name: OAuth2
  source: openapi/uscis-case-status-api-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://api-int.uscis.gov/oauth/accesstoken
  description: OAuth 2.0 Client Credentials flow. Obtain an access token from the USCIS token
    endpoint using your client_id and client_secret registered at developer.uscis.gov. Tokens
    expire after 1,800 seconds (30 minutes).
- name: OAuth2
  source: openapi/uscis-foia-api-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://api-int.uscis.gov/oauth/accesstoken
  description: OAuth 2.0 Client Credentials flow. Obtain an access token from the USCIS token
    endpoint using your client_id and client_secret registered at developer.uscis.gov. Tokens
    expire after 1,800 seconds (30 minutes).
scopes:
- scope: read:case-status
  description: Read immigration case status information
  flows:
  - clientCredentials
  sources:
  - openapi/uscis-case-status-api-openapi.yml
- scope: read:foia-requests
  description: Read FOIA request status
  flows:
  - clientCredentials
  sources:
  - openapi/uscis-foia-api-openapi.yml
- scope: write:foia-requests
  description: Submit FOIA requests
  flows:
  - clientCredentials
  sources:
  - openapi/uscis-foia-api-openapi.yml