Overview

Call the SESAR API to register, find, and update sample metadata.

This section is for software that talks to SESAR. The OpenAPI reference (next in the sidebar) is the contract: every path, field, and status code. The pages after it are short how-tos for the workflows the spec does not spell out in order.

Environment	Base URL
Production	https://api.geosamples.org/api/
Sandbox (for testing)	https://api-sandbox.geosamples.org/api/

Use the sandbox host while you develop and test. Use production only when you intend to create or change real sample records.

Send JSON. Writes and private reads need Authorization: Bearer plus an access token from Authentication. Listing published samples does not.

If you want to…	Start here
Get a JWT	Authentication
Mint an IGSN	Register a sample
Search or load one sample	Find or fetch a sample
Change metadata	Update a sample
Move off upload.php / XML	Migrating from v1 web services
See every field	OpenAPI reference, grouped by tag

Allowed values live in the Vocabularies section. What each sample field means, and which ones are required, is in Metadata Schema.