Get Contract ID

Step 2: Verifying Available Contracts

Listing available contracts for an API Credential

Once you have an access token, verify the contracts associated with your API credentials:

curl --location --request GET 'https://api.satellogic.com/contracts' \
--header 'authorizationToken: Bearer <ACCESS_TOKEN>'

The response will list all contracts available to your credentials:

[
    {
        "contract_id": "contract-123",
        "name": "Enterprise Imagery Access",
    }
]

Step 3: Making API Requests

⚠️ IMPORTANT: All API requests require both: - The access token in the authorizationToken header - The contract ID in the X-Satellogic-Contract-Id header

Failing to provide either will result in an unauthorized response.

The only endpoint that can be used without the X-Satellogic-Contract-Id header is /contracts.

Requesting Tasking Products

curl --location --request GET 'https://api.satellogic.com/tasking/products' \
--header 'authorizationToken: Bearer <ACCESS_TOKEN>' \
--header 'X-Satellogic-Contract-Id: contract-123'

Searching Archive Products

curl --location --request POST 'https://api.satellogic.com/archive/search' \
--header 'authorizationToken: Bearer <ACCESS_TOKEN>' \
--header 'X-Satellogic-Contract-Id: contract-123' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bbox": [-122.4, 37.7, -122.3, 37.8],
    "start_date": "2024-01-01",
    "end_date": "2024-02-01"
}'