Querying Data

The GSM query endpoints use a shared filtering syntax based on query parameters.

This applies to:

/catalogue-metadata for catalogue metadata rows.
/local-sky-model for sky component rows (after cone search and catalogue selection).

Supported operators

Supported filter operators
Operator	Description	Example
`eq`	Equality comparison (default)	`version=1.0.0`
`ne`	Not equal	`catalogue_name__ne=GLEAM`
`gt`	Greater than	`version__gt=1.0`
`gte`	Greater than or equal to	`version__gte=2.0`
`lt`	Less than	`version__lt=2.0`
`lte`	Less than or equal to	`version__lte=3.0`
`contains`	Case-insensitive substring search	`catalogue_name__contains=GLEAM`
`startswith`	Case-insensitive prefix search	`catalogue_name__startswith=GL`
`endswith`	Case-insensitive suffix search	`catalogue_name__endswith=FAR`
`in`	Match any value in a comma-separated list	`catalogue_name__in=GLEAM,LOFAR`

Combine minimum and maximum bounds using gte and lte.

Metadata example:

GET /catalogue-metadata?version__gte=2.0&version__lte=3.0

Flux example:

GET /local-sky-model?ra_deg=70&dec_deg=4&fov_deg=1&catalogue_name=example&version=1.0.0&i_pol_jy__gte=0.5&i_pol_jy__lte=1.0

The shared query parser also supports:

sort: Order results by one or more fields. Prefix a field with - for descending order. Example: sort=-i_pol_jy,ra_deg sorts by i_pol_jy descending, then ra_deg ascending.
fields: Select which columns to include in the response. Provide a comma-separated list of field names. Example: fields=ra_deg,dec_deg,i_pol_jy returns only those columns in each result.
limit: Restrict the maximum number of rows returned. Example: limit=100 returns at most 100 results.

Full example combining these options:

GET /local-sky-model?sort=-i_pol_jy&fields=ra_deg,dec_deg,i_pol_jy&limit=50