Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Embat Authentication API

`Authentication` provides the credentials Embat issues to access the rest of the public API. Every other endpoint requires a JWT `idToken` in the `Authorization: Bearer ` header; requests with no token, or with an invalid or expired one, are rejected with `401`.An `email`/`password` pair identifies a service user with access to a group of companies in Embat. Keep these credentials secret: never commit them to a repository, embed them in client-side code, or expose them in publicly accessible logs.**Typical flow:**1. Exchange your `email`/`password` for a bearer token:```jsonPOST /authentication/token{ "email": "erp-integration@acme-corp.com", "password": "your-service-password"}```which returns:```json{ "idToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE5YzY4In0..." }```2. Send that token as `Authorization: Bearer ` on every subsequent request.3. The token expires **60 minutes** after issuance. Call `/authentication/token` again with the same credentials to get a new one; there is no separate refresh endpoint.4. Accounts with multi-factor authentication enabled cannot authenticate through this endpoint.5. If `email` or `password` is missing or malformed, the validation error response never echoes back the submitted values, so credentials are never reflected in error output.All requests must be made over **HTTPS**.

Embat Authentication API is one of 22 APIs that Embat publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 1 operation across 1 path, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version 2.120.3.

Requests are made against the base URL https://api.embat.io.

1 operations 1 paths 5 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.120.3
Base URL
https://api.embat.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Embat Authentication API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Authentication 1

Authentication provides the credentials Embat issues to access the rest of the public API. Every other endpoint requires a JWT idToken in the Authorization: Bearer header; request…

POST
/authentication/token
Generate access token
auth_token_authentication_token_post body → 200400401500422

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are ValidationError (5 properties), PostAuthenticationRequestSchema (2 properties), HTTPValidationError (1 property), ErrorResponse (1 property). Each schema is shown below with its type and property counts.

PostAuthenticationResponseSchema
object
1 property 1 required
ErrorResponse
object
Error payload returned by the API (FastAPI detail convention).
1 property 1 required
HTTPValidationError
object
1 property
ValidationError
object
5 properties 3 required
PostAuthenticationRequestSchema
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

embat-authentication-api-openapi.yml Raw ↑

Other APIs Embat publishes across the network.

Embat AccountingAccounts API
Embat AccountingEntries API
Embat Attributes API
Embat Balances API
Embat Banks API
Embat Categories API
Embat Companies API
Embat Contacts API
Embat DebtScheduleConfigs API
Embat Files API
Embat Forecasts API
Embat ForeignExchangeRates API