homeit
API docs by Redocly

homeit Auth API (2.2)

Download OpenAPI specification:

homeit Backend: api@homeit.io License: Creative Commons Attribution 3.0 Unported Terms of Service

Introduction

homeit is a property management system, designed for short-term rentals. The homeit platform allows you to manage all your properties from a single place.

The homeit Auth API allows you to manage your user settings, organization, and API keys, and login via OAuth2.

If you have any suggestions or questions regarding this API, please send us an email.

These documentation pages were automatically generated from an OpenAPI file, and are intended to be used by developers as detailed descriptions of our API.

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC 2119] [RFC 8174] when, and only when, they appear in all capitals, as shown here.

What this API does for partners

The homeit Auth API allows partners to integrate with the homeit network.

  • Integration Platforms can use OAuth2 to access protected resources.

Our API is REST-compliant and uses resource-oriented URLs and common HTTP response codes to indicate API errors.

This document is entirely written in English. Similarly, all enumerated values used in this API are also written in English.

Overview

The API is available at https://auth.homeit.io/v2.

This API consists of several resource routes. Each resource route allows a user to find, create, update or remove a specific resource type.

All resource routes follow the same structure and offer similar high-level functionality. When applicable, resource routes include the following endpoints:

  • GET /{{resource}}: Find all available resources the authenticated user is allowed to access. Search query parameters may be used to filter results.
  • POST /{{resource}}: Create a new resource.
  • GET /{{resource}}/{{id}}: Get a specific resource by its ID.
  • PUT /{{resource}}/{{id}}: Update a specific resource.
  • DELETE /{{resource}}/{{id}}: Remove a specific resource.

For example, to update the name of a User resource with ID 123456 to "HOMEIT", an HTTP PUT request should be sent to https://auth.homeit.io/v2/users/123456 with the body {"name":"HOMEIT"}.

Document Structure

This document's first sections provide details on how to use the API, including security considerations, data formats, and testing instructions.

Then, all resource routes are listed. In this section, you will find request and response formats for each resource type, as well as example responses and code snippets.

Finally, we include the data model for each resource type, along with data type requirements and example values. Fields present in a resource document but not included in the resource's data model should not be used, as they are subject to change at any moment without prior notice. Deprecated fields will be marked as such and should also not be used.

Security

HTTPS

All API requests must be made over HTTPS. Requests made over HTTP will be redirected to HTTPS.

Authentication

Most API routes require authentication using an API Key or a Bearer token. Requests made without authentication will fail with a 401 Unauthorized error.

When applicable, requests may be authenticated using one of the following methods:

  • API Key: Used as a query parameter. Example: https://api.homeit.io/v2/resource?apikey={{apikey}}
  • OAuth2: The OAuth2 flows produce tokens in the JSON Web Token format. This authentication method is fully compliant with the OAuth2 standard. These tokens can be used as a bearer token in the Authorization HTTP header. Example: Authorization: Bearer {{token}}

You can find additional information in the Authentication section.

Rate Limits

If too many requests are sent in a short amount of time, a 429 Too Many Requests error is returned until request rates return to normal. Client applications should honour the following request rate limits:

  • 100 requests per second
  • 1000 requests per minute

Pagination

All operations are automatically paginated in the following way:

{ docs: [], total: 120, limit: 10, skip: 0 }

Operations which return a single resource are still paginated, but will show total and limit values of 1.

You can define a limit on the number of documents to be returned which can range between 1 and 100 items. The default is 10 items.

Similarly, you can skip any number of documents, effectively setting the starting position by providing an index. This index should not exceed the total amount of available documents.

For example, https://auth.homeit.io/v2/users?limit=100&skip=10 returns at most 100 items, skipping the first 10 documents.

Sorting

All list operations can be sorted by any of the document's fields, as long as its assigned value is a number, a string or a date.

The sortBy parameter provides the key you want to sort by, while the order parameter tells the API in which order you want your results: asc for ascending and desc for descending.

For example, https://auth.homeit.io/v2/users?sortBy=id&order=desc returns items sorted by ID, in descending order.

Hypermedia

All operations return a collection of hypermedia links to other pages of the same request or other related requests. This collection follows the HAL format.

This behavior can be disabled by setting the hypermedia query parameter to false.

For example, https://auth.homeit.io/v2/users?hypermedia=false returns a response without hypermedia information.

Formatting

JSON

All API responses are given in JSON format. All request bodies should also be provided as JSON.

Request body content type should be application/json. Response body content type will always be application/json+hal unless otherwise specified.

Dates

All dates follow the ISO 8601 format standard.

Errors

In case of internal or external error, the following HTTP error codes will be returned:

  • 401 Unauthorized: Request lacks valid authentication credentials.
  • 403 Forbidden: Access to requested resource is not allowed.
  • 404 Not Found: Requested resource could not be found. Also returned if the requested route could not be found.
  • 405 Method Not Allowed: Request HTTP method is not allowed on the requested route or resource.
  • 409 Conflict: Requested data changes create conflicts with current state of resource.
  • 422 Unprocessable Entity: Payload validation failed. Usually accompanied by a detailed explanation message.
  • 429 Too Many Requests: Request rate exceeded rate limits.

Other 4XX and 5XX error codes may be returned upon malformed request payload or gateway errors.

During normal operation, the following HTTP codes will be returned:

  • 201 Created: Successful resource creation operations.
  • 200 OK: All other successful operations.

Testing

All operations accept a dry boolean query parameter. When testing, you can enable dry-run mode by setting this parameter to true.

In this mode, side-effects such as database writes are disabled, but responses are still returned as normal.

For example, an update request to https://auth.homeit.io/v2/users/123?dry=true would return the updated document, but no changes would be persisted.

Feedback

If you would like to report an error or have any suggestions or questions regarding this API, please send us an email to api@homeit.io. Any feedback is greatly appreciated. Please, use English for all communications.

Changelog

2020-11-26

  • First release of this documentation page.

API Keys

Operations related to API Key resources.

Get all API Keys.

Get all API Keys you have access to. You may use filters to narrow your search.

Authorizations:
oauthapikey
query Parameters
q
string
Example: q=Example

Free-text search across indexed resource fields.

limit
integer <int64> [ 1 .. 100 ]
Default: 10
Example: limit=10

Maximum number of resources to return.

skip
integer <int64> >= 0
Default: 0

Number of resources to skip.

sortBy
string
Example: sortBy=dateCreated

Field used to sort the result set.

order
string
Default: "asc"
Enum: "asc" "desc"
Example: order=desc

Sort order.

id
Array of integers <int64> [ items <int64 > ]
Example: id=123

A list of resource IDs.

name
string
Example: name=Example

The resource's name, or part of it. Case-insensitive.

description
string
Example: description=Example

The resource's description, or part of it. Case-insensitive.

user
Array of integers <int64> [ items <int64 > ]
Example: user=1000000

A list of user IDs.

organization
Array of integers <int64> [ items <int64 > ]
Example: organization=1100000000

A list of organization IDs.

tag
Array of strings
Example: tag=tag

Filter by tag.

isTester
Array of booleans <= 2 items
Example: isTester=false

Filter by test data flag.

isActive
boolean
Example: isActive=true

Filter by active status.

createdBefore
string <date-time>
Example: createdBefore=2020-01-01T00:00:00.000Z

Filter by creation date. Format MUST comply with ISO 8601.

createdAfter
string <date-time>
Example: createdAfter=2020-01-01T00:00:00.000Z

Filter by creation date. Format MUST comply with ISO 8601.

updatedBefore
string <date-time>
Example: updatedBefore=2020-01-01T00:00:00.000Z

Filter by last update date. Format MUST comply with ISO 8601.

updatedAfter
string <date-time>
Example: updatedAfter=2020-01-01T00:00:00.000Z

Filter by last update date. Format MUST comply with ISO 8601.

dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

hypermedia
boolean
Default: true

Disable hypermedia links in response.

Responses

Request samples 

curl -XGET "https://auth.homeit.io/v2/apikeys?user=1000000&name=Example" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 2,
  • "limit": 10,
  • "skip": 0,
  • "success": true
}

Create an API Key.

Create a new API Key.

Authorizations:
oauthapikey
query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Request Body schema: application/json
required

API Key object.

name
required
string

The API Key's name.

description
string

The API Key's description.

scope
Array of strings

A list of authorization scopes.

expires
string <date-time>

Expiration date and time. Format MUST comply with ISO 8601.

Responses

Request samples

Content type
application/json
{
  • "name": "Example API key",
  • "description": "Example description"
}

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Get an API Key.

Get a single API Key by ID.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

Responses

Request samples 

curl -XGET "https://auth.homeit.io/v2/apikeys/1200000000" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Update an API Key.

Update an API Key you own.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Request Body schema: application/json
required

API Key object.

name
string

The API Key's name.

description
string

The API Key's description.

expires
string <date-time>

Expiration date and time. Format MUST comply with ISO 8601.

Responses

Request samples

Content type
application/json
{
  • "name": "Updated API key",
  • "description": "Updated description"
}

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Delete an API Key.

Delete an API Key you own.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Responses

Request samples 

curl -XDELETE "https://auth.homeit.io/v2/apikeys/1200000000" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Organizations

Operations related to Organization resources.

Get all Organizations.

Get all Organizations you have access to. You may use filters to narrow your search.

Authorizations:
oauthapikey
query Parameters
q
string
Example: q=Example

Free-text search across indexed resource fields.

limit
integer <int64> [ 1 .. 100 ]
Default: 10
Example: limit=10

Maximum number of resources to return.

skip
integer <int64> >= 0
Default: 0

Number of resources to skip.

sortBy
string
Example: sortBy=dateCreated

Field used to sort the result set.

order
string
Default: "asc"
Enum: "asc" "desc"
Example: order=desc

Sort order.

id
Array of integers <int64> [ items <int64 > ]
Example: id=123

A list of resource IDs.

name
string
Example: name=Example

The resource's name, or part of it. Case-insensitive.

description
string
Example: description=Example

The resource's description, or part of it. Case-insensitive.

vatin
string
Example: vatin=PT999999999

Filter by VAT identifier.

customerId
Array of strings
Example: customerId=customer0

Filter by external customer identifier.

accountingId
Array of strings
Example: accountingId=account0

Filter by external accounting identifier.

subscription
Array of strings
Example: subscription=subscription

Filter by subscription code.

subscriptionPeriodEndBefore
string <date-time>
Example: subscriptionPeriodEndBefore=2030-01-01T00:00:00.000Z

Filter by subscription period end date. Format MUST comply with ISO 8601.

subscriptionPeriodEndAfter
string <date-time>
Example: subscriptionPeriodEndAfter=2020-01-01T00:00:00.000Z

Filter by subscription period end date. Format MUST comply with ISO 8601.

tag
Array of strings
Example: tag=tag

Filter by tag.

isTester
Array of booleans <= 2 items
Example: isTester=false

Filter by test data flag.

isActive
boolean
Example: isActive=true

Filter by active status.

createdBefore
string <date-time>
Example: createdBefore=2020-01-01T00:00:00.000Z

Filter by creation date. Format MUST comply with ISO 8601.

createdAfter
string <date-time>
Example: createdAfter=2020-01-01T00:00:00.000Z

Filter by creation date. Format MUST comply with ISO 8601.

updatedBefore
string <date-time>
Example: updatedBefore=2020-01-01T00:00:00.000Z

Filter by last update date. Format MUST comply with ISO 8601.

updatedAfter
string <date-time>
Example: updatedAfter=2020-01-01T00:00:00.000Z

Filter by last update date. Format MUST comply with ISO 8601.

dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

hypermedia
boolean
Default: true

Disable hypermedia links in response.

Responses

Request samples 

curl -XGET "https://auth.homeit.io/v2/organizations?subscription=subscription&name=Example" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 2,
  • "limit": 10,
  • "skip": 0,
  • "success": true
}

Create an Organization.

Create a new Organization.

Authorizations:
oauthapikey
query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Request Body schema: application/json
required

Organization object.

name
required
string

The Organization's name.

description
string

The Organization's description.

email
string <email>

The Organization's contact email.

vatin
string

The Organization's VAT identification number.

string or object

Organization postal address.

object

Coordinates used for geocoding the organization address.

timezone
string

IANA timezone identifier.

Responses

Request samples

Content type
application/json
{
  • "name": "Example organization",
  • "email": "org@example.com",
  • "description": "Example description"
}

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Get an Organization.

Get a single Organization by ID.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

Responses

Request samples 

curl -XGET "https://auth.homeit.io/v2/organizations/1" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Update an Organization.

Update an Organization you own.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Request Body schema: application/json
required

Organization object.

name
string

The Organization's name.

description
string

The Organization's description.

email
string <email>

The Organization's contact email.

vatin
string

The Organization's VAT identification number.

string or object

Organization postal address.

object

Coordinates used for geocoding the organization address.

timezone
string

IANA timezone identifier.

Responses

Request samples

Content type
application/json
{
  • "name": "Updated organization",
  • "description": "Updated description"
}

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Delete an Organization.

Delete an Organization you own.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Responses

Request samples 

curl -XDELETE "https://auth.homeit.io/v2/organizations/1" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Users

Operations related to User resources.

Get all Users.

Get all Users you have access to. You may use filters to narrow your search.

Authorizations:
oauthapikey
query Parameters
q
string
Example: q=Example

Free-text search across indexed resource fields.

limit
integer <int64> [ 1 .. 100 ]
Default: 10
Example: limit=10

Maximum number of resources to return.

skip
integer <int64> >= 0
Default: 0

Number of resources to skip.

sortBy
string
Example: sortBy=dateCreated

Field used to sort the result set.

order
string
Default: "asc"
Enum: "asc" "desc"
Example: order=desc

Sort order.

id
Array of integers <int64> [ items <int64 > ]
Example: id=123

A list of resource IDs.

name
string
Example: name=Example

The resource's name, or part of it. Case-insensitive.

email
string
Example: email=example@example.com

An email address, or part of it. Case-insensitive.

phone
Array of strings
Example: phone=+351912345678

A phone number, or part of it.

organization
Array of integers <int64> [ items <int64 > ]
Example: organization=1100000000

A list of organization IDs.

organizationRole
Array of strings
Example: organizationRole=member

Filter by organization role.

lastLoginBefore
string <date-time>
Example: lastLoginBefore=2020-01-01T00:00:00.000Z

Filter by last login date. Format MUST comply with ISO 8601.

lastLoginAfter
string <date-time>
Example: lastLoginAfter=2020-01-01T00:00:00.000Z

Filter by last login date. Format MUST comply with ISO 8601.

mfaType
Array of strings
Example: mfaType=totp

Filter by MFA type.

federationProvider
Array of strings
Example: federationProvider=google

Filter by federation provider.

language
Array of strings
Example: language=en

Filter by user language.

tag
Array of strings
Example: tag=tag

Filter by tag.

isTester
Array of booleans <= 2 items
Example: isTester=false

Filter by test data flag.

isActive
boolean
Example: isActive=true

Filter by active status.

createdBefore
string <date-time>
Example: createdBefore=2020-01-01T00:00:00.000Z

Filter by creation date. Format MUST comply with ISO 8601.

createdAfter
string <date-time>
Example: createdAfter=2020-01-01T00:00:00.000Z

Filter by creation date. Format MUST comply with ISO 8601.

updatedBefore
string <date-time>
Example: updatedBefore=2020-01-01T00:00:00.000Z

Filter by last update date. Format MUST comply with ISO 8601.

updatedAfter
string <date-time>
Example: updatedAfter=2020-01-01T00:00:00.000Z

Filter by last update date. Format MUST comply with ISO 8601.

dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

hypermedia
boolean
Default: true

Disable hypermedia links in response.

Responses

Request samples 

curl -XGET "https://auth.homeit.io/v2/users?email=example@example.com&organization=1100000000" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 2,
  • "limit": 10,
  • "skip": 0,
  • "success": true
}

Create a User.

Create a new User.

Authorizations:
oauthapikey
query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Request Body schema: application/json
required

User object.

name
string

The User's display name.

email
required
string <email>

The User's email address.

phone
string

The User's phone number.

password
string

The User's password.

language
string

The user's preferred language.

about
string

Free-form profile description.

Responses

Request samples

Content type
application/json
{
  • "name": "Example user",
  • "email": "user@example.com",
  • "password": "example-password"
}

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Get a User.

Get a single User by ID.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

Responses

Request samples 

curl -XGET "https://auth.homeit.io/v2/users/1" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Update a User.

Update a User you own.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Request Body schema: application/json
required

User object.

name
string

The User's display name.

email
string <email>

The User's email address.

phone
string

The User's phone number.

password
string

The User's password.

language
string

The user's preferred language.

about
string

Free-form profile description.

Responses

Request samples

Content type
application/json
{
  • "name": "Updated user",
  • "about": "Updated profile description"
}

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

Delete a User.

Delete a User you own.

Authorizations:
oauthapikey
path Parameters
id
required
integer <int64>
Example: 123

A resource's ID.

query Parameters
dry
boolean
Default: false
Example: dry=true

Enable dry-run mode, for testing.

Responses

Request samples 

curl -XDELETE "https://auth.homeit.io/v2/users/1" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer {{token}}"

Response samples

Content type
application/json+hal
{
  • "docs": [
    ],
  • "total": 1,
  • "limit": 1,
  • "skip": 0,
  • "success": true
}

API Key

id
integer <int64>

The API Key's numeric ID.

name
string

The API Key's name.

description
string

The API Key's description.

user
integer <int64>

The user that owns the API Key.

organization
integer <int64>

The organization associated with the API Key.

token
string

The API Key token value.

scope
Array of strings

A list of authorization scopes.

expires
string <date-time>

Expiration date and time. Format MUST comply with ISO 8601.

tags
Array of strings

Arbitrary labels assigned to the API Key.

isTester
boolean

Is the API Key intended for testing?

isActive
boolean (isActive)

Is the resource active?

createdBy
integer <int64>

The user that created the API Key.

dateCreated
string <date-time> (dateCreated)

Creation date and time. Format MUST comply with ISO 8601.

updatedBy
integer <int64>

The user that last updated the API Key.

dateUpdated
string <date-time> (dateUpdated)

Last update date and time. Format MUST comply with ISO 8601.

deleted
boolean (deleted)

Is the resource deleted?

deletedAt
string <date-time> (deletedAt)

Deletion date and time. Format MUST comply with ISO 8601.

deletedBy
integer <int64>

The user that deleted the API Key.

API Key example

{
  • "id": 1200000000,
  • "name": "name0",
  • "description": "description",
  • "user": 1000000,
  • "organization": 1100000000,
  • "token": "token",
  • "scope": [
    ],
  • "expires": "2100-01-01T00:00:00.000Z",
  • "tags": [
    ],
  • "isTester": false,
  • "isActive": true,
  • "createdBy": 1000000,
  • "updatedBy": 1000000,
  • "dateCreated": "2020-01-01T00:00:00.000Z",
  • "dateUpdated": "2020-01-01T00:00:00.000Z",
  • "deleted": false
}

Organization

id
integer <int64>

The Organization's numeric ID.

name
string

The Organization's name.

description
string

The Organization's description.

email
string <email>

The Organization's contact email.

vatin
string

The Organization's VAT identification number.

customerId
string

External customer identifier.

accountingId
string

External accounting identifier.

subscriptions
Array of strings

Organization subscription codes.

subscriptionQuantity
integer

Number of subscribed units.

subscriptionPeriodEnd
string <date-time>

Subscription period end date and time. Format MUST comply with ISO 8601.

object

Organization postal address.

object

Organization geographic location.

timezone
string

IANA timezone identifier.

tags
Array of strings

Arbitrary labels assigned to the Organization.

isTester
boolean

Is the Organization intended for testing?

isActive
boolean (isActive)

Is the resource active?

createdBy
integer <int64>

The user that created the Organization.

dateCreated
string <date-time> (dateCreated)

Creation date and time. Format MUST comply with ISO 8601.

updatedBy
integer <int64>

The user that last updated the Organization.

dateUpdated
string <date-time> (dateUpdated)

Last update date and time. Format MUST comply with ISO 8601.

deleted
boolean (deleted)

Is the resource deleted?

deletedAt
string <date-time> (deletedAt)

Deletion date and time. Format MUST comply with ISO 8601.

deletedBy
integer <int64>

The user that deleted the Organization.

Organization example

{
  • "id": 1100000000,
  • "name": "name0",
  • "description": "description",
  • "email": "abc@abc.com",
  • "vatin": "vatin0",
  • "customerId": "customer0",
  • "accountingId": "user0",
  • "subscriptions": [
    ],
  • "subscriptionQuantity": 1,
  • "subscriptionPeriodEnd": "2100-01-01T00:00:00.000Z",
  • "address": {
    },
  • "location": {
    },
  • "timezone": "Etc/UTC",
  • "tags": [
    ],
  • "isTester": false,
  • "isActive": true,
  • "createdBy": 1000000,
  • "updatedBy": 1000000,
  • "dateCreated": "2020-01-01T00:00:00.000Z",
  • "dateUpdated": "2020-01-01T00:00:00.000Z",
  • "deleted": false
}

User

id
integer <int64>

The User's numeric ID.

name
string

The User's display name.

email
string <email>

The User's email address.

phone
string

The User's phone number.

emailVerified
boolean

Whether the email address has been verified.

phoneVerified
boolean

Whether the phone number has been verified.

forceReset
boolean

Whether the user must reset the password.

organization
integer <int64>

The organization the user belongs to.

organizationRole
string
Enum: "owner" "admin" "member" "billing"

The user's role within the organization.

scopes
Array of strings

The user's granted scopes.

lastLogin
string <date-time>

Last login date and time. Format MUST comply with ISO 8601.

mfaType
string
Value: "totp"

Multi-factor authentication type.

federationProvider
string

External federation provider name.

language
string

The user's preferred language.

about
string

Free-form profile description.

tags
Array of strings

Arbitrary labels assigned to the user.

isTester
boolean

Is the user intended for testing?

isActive
boolean (isActive)

Is the resource active?

createdBy
integer <int64>

The user that created the account.

dateCreated
string <date-time> (dateCreated)

Creation date and time. Format MUST comply with ISO 8601.

updatedBy
integer <int64>

The user that last updated the account.

dateUpdated
string <date-time> (dateUpdated)

Last update date and time. Format MUST comply with ISO 8601.

deleted
boolean (deleted)

Is the resource deleted?

deletedAt
string <date-time> (deletedAt)

Deletion date and time. Format MUST comply with ISO 8601.

deletedBy
integer <int64>

The user that deleted the account.

User example

{
  • "id": 1000000,
  • "name": "name0",
  • "email": "abc@abc.com",
  • "phone": "+351987654321",
  • "emailVerified": true,
  • "phoneVerified": true,
  • "forceReset": false,
  • "organization": 1,
  • "organizationRole": "member",
  • "scopes": [
    ],
  • "language": "pt",
  • "about": "",
  • "tags": [
    ],
  • "isTester": false,
  • "isActive": true,
  • "createdBy": 1000000,
  • "updatedBy": 1000000,
  • "dateCreated": "2020-01-01T00:00:00.000Z",
  • "dateUpdated": "2020-01-01T00:00:00.000Z",
  • "deleted": false
}