Skip to content
Space Invoices Documentation

Users

Users

User authentication and profile operations. Users can access multiple entities and manage their account settings.

Endpoints
IntroductionPOST/users/loginPOST/users/signupPOST/users/password-resetPOST/users/password-reset/confirmGET/users/me/accountsGET/users/mePATCH/users/mePUT/users/me/settings/fursPUT/users/me/settings/finaPUT/users/me/settings/pt

Login user

POST/users/login

Authenticate a user with email and password. Returns an access token and the resolved user profile for the current brand or white-label origin.

Request

Body parameters

emailstring<email>required
passwordstringrequired
curl -X POST "https://eu.spaceinvoices.com/users/login" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "string",
    "password": "string"
  }'
Response

Returns

idstring
Other parameters
user_idstring
ttlnumber
scopestringnullable
created_atstring<date-time>
impersonator_user_idstringnullable
updated_atstring<date-time>
userobject
redirect_originstringnullable
json
{
  "id": "string",
  "user_id": "string",
  "ttl": 31536000,
  "scope": "string",
  "created_at": "2025-01-15T10:30:00.000Z",
  "impersonator_user_id": "string",
  "updated_at": "2025-01-15T10:30:00.000Z",
  "user": {
    "id": "string",
    "email": "string",
    "name": "string",
    "email_verified": true,
    "account_id": "string",
    "settings": null,
    "metadata": null,
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  },
  "redirect_origin": "string"
}

Create user

POST/users/signup

Create a new user account. For non-white-label signups this also provisions the initial account membership.

Request

Body parameters

emailstring<email>required
passwordstringrequired
Other parameters
namestringoptionalnullable
settingsoptional
metadataobjectoptionalnullable
company_namestringoptional
curl -X POST "https://eu.spaceinvoices.com/users/signup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "string",
    "name": "string",
    "password": "string",
    "settings": null,
    "metadata": {},
    "company_name": "string"
  }'
Response

Returns

idstring
Other parameters
emailstring
namestringnullable
email_verifiedboolean
account_idstringnullable
settings
metadataobjectnullable
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "string",
  "email": "string",
  "name": "string",
  "email_verified": true,
  "account_id": "string",
  "settings": null,
  "metadata": {},
  "created_at": "2025-01-15T10:30:00.000Z",
  "updated_at": "2025-01-15T10:30:00.000Z"
}

Request password reset

POST/users/password-reset

Request a password reset email. Always returns success to avoid email enumeration.

Request

Body parameters

emailstring<email>required
curl -X POST "https://eu.spaceinvoices.com/users/password-reset" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "string"
  }'
Response

Returns

messagestring
json
{
  "message": "string"
}

Confirm password reset

POST/users/password-reset/confirm

Reset a user password with a valid password reset token.

Request

Body parameters

tokenstringrequired
passwordstringrequired
curl -X POST "https://eu.spaceinvoices.com/users/password-reset/confirm" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "string",
    "password": "string"
  }'
Response

Returns

messagestring
json
{
  "message": "string"
}

List current user accounts

GET/users/me/accounts

Return the accounts the authenticated user belongs to, including display names and account-level roles.

Response

Returns

dataarray of objects
json
{
  "data": [
    {
      "id": "string",
      "name": "string",
      "role": "owner"
    }
  ]
}

Get current user

GET/users/me

Retrieve the authenticated user's profile information. Returns the user details associated with the provided Bearer token.

Response

Returns

idstring
Other parameters
emailstring
namestringnullable
email_verifiedboolean
account_idstringnullable
settings
metadata
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "6595a27b5d35015c3ef0c3fd",
  "email": "example@spaceinvoices.com",
  "email_verified": false,
  "name": null,
  "account_id": null,
  "metadata": {},
  "settings": {},
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Update current user

PATCH/users/me

Update the authenticated user's profile. Currently supports updating the display name and preferred UI language (locale).

Request

Body parameters

namestringoptionalnullable
localestringoptionalnullable
curl -X PATCH "https://eu.spaceinvoices.com/users/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "sl"
  }'
Response

Returns

idstring
Other parameters
emailstring
namestringnullable
email_verifiedboolean
account_idstringnullable
settings
metadata
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "6595a27b5d35015c3ef0c3fd",
  "email": "example@spaceinvoices.com",
  "email_verified": false,
  "name": null,
  "account_id": null,
  "metadata": {},
  "settings": {},
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Update user FURS operator settings

PUT/users/me/settings/furs

Update FURS operator settings (tax number, label) for the current user. Settings are stored per-entity using the x-entity-id header. These settings are used when the user creates invoices through the web interface.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

operator_tax_numberstringoptional
operator_labelstringoptional
curl -X PUT "https://eu.spaceinvoices.com/users/me/settings/furs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "operator_tax_number": "12345678",
    "operator_label": "John Doe"
  }'
Response

Returns

idstring
Other parameters
emailstring
namestringnullable
email_verifiedboolean
account_idstringnullable
settings
metadata
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "6595a27b5d35015c3ef0c3fd",
  "email": "example@spaceinvoices.com",
  "email_verified": false,
  "name": null,
  "account_id": null,
  "metadata": {},
  "settings": {},
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Update user FINA operator settings

PUT/users/me/settings/fina

Update FINA operator settings (OIB, label) for the current user. Settings are stored per-entity using the x-entity-id header. These settings are used when the user creates invoices through the web interface.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

operator_oibstringoptional
operator_labelstringoptional
curl -X PUT "https://eu.spaceinvoices.com/users/me/settings/fina" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "operator_oib": "12345678901",
    "operator_label": "Ivan Horvat"
  }'
Response

Returns

idstring
Other parameters
emailstring
namestringnullable
email_verifiedboolean
account_idstringnullable
settings
metadata
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "6595a27b5d35015c3ef0c3fd",
  "email": "example@spaceinvoices.com",
  "email_verified": false,
  "name": null,
  "account_id": null,
  "metadata": {},
  "settings": {},
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Update user Portugal operator settings

PUT/users/me/settings/pt

Update PT operator snapshot settings for the current user. Settings are stored per-entity using the x-entity-id header and used to auto-fill PT operator fields when the user creates PT documents.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

operator_first_namestringoptional
operator_last_namestringoptional
operator_tax_numberstringoptional
account_first_namestringoptional
account_last_namestringoptional
account_tax_numberstringoptional
curl -X PUT "https://eu.spaceinvoices.com/users/me/settings/pt" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "account_first_name": "Joao",
    "account_last_name": "Silva",
    "account_tax_number": "123456789"
  }'
Response

Returns

idstring
Other parameters
emailstring
namestringnullable
email_verifiedboolean
account_idstringnullable
settings
metadata
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "6595a27b5d35015c3ef0c3fd",
  "email": "example@spaceinvoices.com",
  "email_verified": false,
  "name": null,
  "account_id": null,
  "metadata": {},
  "settings": {},
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}