Skip to main content

API Configuration

GET /api/v0/config
Returns the API configuration including supported chains and the EAS schema used for location attestations.

Example

curl "https://api.astral.global/api/v0/config"

Response

{
  "chains": {
    "base-sepolia": true,
    "sepolia": true,
    "arbitrum": true,
    "celo": true,
    "base": false
  },
  "schema": "0xba4171c92572b1e4f241d044c32cdf083be9fd946b8766977558ca6378c824e2",
  "schema_fields": "uint256 eventTimestamp,string srs,string locationType,string location,string[] recipeType,bytes[] recipePayload,string[] mediaType,string[] mediaData,string memo",
  "version": "v0"
}

Response Fields

FieldTypeDescription
chainsobjectSupported chains and their active status
schemastringEAS schema UID for location attestations
schema_fieldsstringSchema field definitions
versionstringAPI version

Schema Fields Explained

FieldTypeDescription
eventTimestampuint256Unix timestamp of the location event
srsstringSpatial reference system (e.g., “EPSG:4326”)
locationTypestringFormat identifier (e.g., “geojson-point”)
locationstringStringified location data
recipeTypestring[]Location derivation methods
recipePayloadbytes[]Method-specific data
mediaTypestring[]MIME types of attached media
mediaDatastring[]Base64-encoded media
memostringOptional description
This schema follows the Location Protocol v0.2 specification. Verification is in progress — see Location Records for details.