A session represents a single verification flow against one tag. It’s the thread that connects one scan to the next so the platform can resolve them into one verdict.
Fields
| Field | Type | Notes |
|---|---|---|
id |
string | ses_-prefixed, assigned by the platform. |
A session belongs to a tag and groups the
verifications produced as the flow resolves — a
pending, then its valid / invalid resolution.
Where sessions come from
You don’t create a session directly. The platform opens one for you when a scan
arrives without tagbase_session_id and returns its id in the verification
response, under data.relationships.session:
"relationships": {
"session": { "data": { "type": "sessions", "id": "ses_abcdef0123456789" } }
}
Using a session
Carry that session id back as tagbase_session_id on a later scan so the
platform continues the session rather than starting a new flow. See
Verifications → Sessions and resolution for the full
sequence.
A session is live for 10 minutes. A scan after that window opens a fresh session instead of resolving the old one.
Notes
- Sessions are not independently addressable — there is no endpoint to fetch a session by id. They appear only as a relationship on a verification. Hold the id on your side for as long as the flow runs.