This can be used to search/filter and retrieve records in their raw ISO 19115 form. If authenticated, this API can also be used to create, update or delete records.
This API is part of the SCAR ADD Metadata Toolbox project.
Limited, best efforts, support is offered for this API.
Contact the BAS Service Desk in the first instance.
This API is provided by the British Antarctic Survey (BAS) on behalf of the Scientific Committee on Antarctic Research (SCAR). BAS is part of UK Research and Innovation (URKI), who are the legal operator of this service.
Reasonable policies and technical measures are in place to ensure information in this API is held and transferred securely. Where third parties are used to operate this API, they are used for a necessary task with measures in place to ensure they are used appropriately and securely.
Third party services used by this API are:
- Sentry - for monitoring API errors, which may include API responses
Seek support if you have any questions about how information is used by this API is used or managed. If you do not receive a prompt reply, you can contact the BAS Freedom of Information Officer directly.
Seek support to disclose any security concerns with this API. Contact us first for instructions if you need to report any sensitive information.
This API is versioned. An API version must be specified as a URL prefix (e.g.
Only the latest, stable, API version is supported. When a new version is released, all previous versions are deprecated to allow clients time to move to a supported version. After a period of time, deprecated versions are retired and no longer accessible.
This API implements OGC CSW 2.0.2, including the transactional profile for modifying records.
CSW Output Schemas
http://www.isotc211.org/2005/gmd (ISO 19115/19139) output schema is officially supported by this API.
text/xml content type is officially supported by this API.
UTF-8 character encoding scheme is officially supported by this API.
Errors covered by the CSW standard will use the relevant error format and content specified by the standard.
Other errors will be returned in a logical but non-standardised form using the
application/json media type.
All responses will include a
X-Request-ID header to aid debugging requests through different components.
If desired, a custom request ID can be specified by the client which will be used instead of, or in addition to, the automatically generated value.
Note: In some cases a client specified value will be ignored, you MUST NOT rely on this value being returned.
Note: This header MAY include multiple values (multiple Request IDs) separated by a
, and possible whitespace.
Authentication and authorisation
Parts of this API require authentication and suitable authorisation to access. This will be highlighted in the Usage section where it applies.
All API requests should use
https://api.bas.ac.uk/data/metadata/add/csw/v1 as a base path.
Where an API request is authenticated/authorised, an
Authorization header containing a bearer token must be specified.
Authorisation: Bearer [token]
Bearer tokens are OAuth access tokens issued by Microsoft Azure’s OAuth endpoints using a supported code flow. Clients must be registered before they can make authenticated/authorised requests.
Contact Support for registering new clients or for information on how to request access tokens.
This API consists of a single resource, Catalogues.
Catalogues represent CSW instances. The ADD Data Catalogue includes two catalogues:
- Published (
published) - containing published records available to the public
- Unpublished (
unpublished) - containing draft, or otherwise unpublished, records restricted to ADD project staff
CSW requests must target a catalogue using a path prefix, e.g.
/published, followed by a valid CSW request.
Access to parts of this resource require authentication and authorisation:
- transactional requests (in either catalogue) are authenticated and restricted to ADD project staff
- requests to read records in the unpublished catalogue are authenticated and restricted to ADD project staff