Lightfield Auth API
The Auth API from Lightfield — 1 operation(s) for auth.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/lightfield-auth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Reference Accounts Auth API
version: 0.0.0
servers:
- url: https://api.lightfield.app/v1
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Auth
paths:
/v1/auth/validate:
get:
operationId: auth.validate
summary: Validate current API key
description: 'Returns metadata for the current API key, including the subject type and granted public scopes. Use this endpoint to confirm a key is active before making scoped API requests.
**[Required scope](/using-the-api/scopes/):** None
**[Rate limit category](/using-the-api/rate-limits/):** Read'
security:
- bearerAuth: []
parameters:
- name: Lightfield-Version
in: header
required: true
description: Required API version header. Requests may error without it.
schema:
type: string
enum:
- '2026-03-01'
default: '2026-03-01'
example: '2026-03-01'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AuthValidateResponse'
'400':
description: '400'
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestError'
'401':
description: '401'
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
'403':
description: '403'
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
'404':
description: '404'
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
'409':
description: '409'
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictError'
'415':
description: '415'
content:
application/json:
schema:
$ref: '#/components/schemas/UnsupportedMediaTypeError'
'422':
description: '422'
content:
application/json:
schema:
$ref: '#/components/schemas/UnprocessableContentError'
'429':
description: '429'
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequestsError'
'500':
description: '500'
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'503':
description: '503'
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailableError'
'504':
description: '504'
content:
application/json:
schema:
$ref: '#/components/schemas/GatewayTimeoutError'
tags:
- Auth
components:
schemas:
ConflictError:
type: object
properties:
type:
const: conflict
message:
type: string
default: Conflict
required:
- type
- message
NotFoundError:
type: object
properties:
type:
const: not_found
message:
type: string
default: Not Found
required:
- type
- message
ServiceUnavailableError:
type: object
properties:
type:
const: service_unavailable
message:
type: string
default: Service Unavailable
required:
- type
- message
UnprocessableContentError:
type: object
properties:
type:
const: unprocessable_content
message:
type: string
default: Unprocessable Content
required:
- type
- message
InternalServerError:
type: object
properties:
type:
const: internal_server_error
message:
type: string
default: Internal Server Error
required:
- type
- message
UnsupportedMediaTypeError:
type: object
properties:
type:
const: unsupported_media_type
message:
type: string
default: Unsupported Media Type
required:
- type
- message
AuthValidateResponse:
type: object
properties:
active:
type: boolean
description: Whether the current API key is valid. Always `true` on successful responses.
tokenType:
enum:
- api_key
description: Credential family, always `api_key`.
subjectType:
enum:
- user
- workspace
description: Whether the API key belongs to a `user` or `workspace`.
scopes:
type: array
items:
type: string
description: Granted public scopes for the current API key. Empty when the key has full access.
required:
- active
- tokenType
- subjectType
- scopes
TooManyRequestsError:
type: object
properties:
type:
const: too_many_requests
message:
type: string
default: Too Many Requests
required:
- type
- message
GatewayTimeoutError:
type: object
properties:
type:
const: gateway_timeout
message:
type: string
default: Gateway Timeout
required:
- type
- message
ForbiddenError:
type: object
properties:
type:
const: forbidden
message:
type: string
default: Forbidden
required:
- type
- message
UnauthorizedError:
type: object
properties:
type:
const: unauthorized
message:
type: string
default: Unauthorized
required:
- type
- message
BadRequestError:
type: object
properties:
type:
const: bad_request
message:
type: string
default: Bad Request
code:
type: string
param:
type: string
required:
- type
- message
- code
securitySchemes:
bearerAuth:
type: http
scheme: bearer