Skip to content
Space Invoices Documentation

Users

Users

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

Endpoints
IntroductionGET/users/mePATCH/users/mePUT/users/me/settings/fursPUT/users/me/settings/finaPUT/users/me/settings/pt

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
namestring
email_verifiedboolean
account_idstring
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

namestringoptional
localestringoptional
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
namestring
email_verifiedboolean
account_idstring
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
namestring
email_verifiedboolean
account_idstring
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
namestring
email_verifiedboolean
account_idstring
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
namestring
email_verifiedboolean
account_idstring
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"
}