Spacebring (andcards)

Download OpenAPI specification:Download

Deprecated. Please use new Spacebring API instead.

The Spacebring API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy.

Before using Spacebring API, please take a moment to familiarize yourself with the product and terminology on Spacebring website.

If you want to be notified about API updates, please subscribe to our newsletter.

Benefits

"Benefit" resource represents a benefit in a certain location.

Retrieve benefits

Retrieve all benefits in the location.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the location

Responses

Response samples

Content type
application/json
{
  • "benefits": [
    ]
}

Benefit Applications

"Benefit Applications" resource represents an application for a benefit in a certain location.

Retrieve benefit applications

Retrieve all benefit applications in the location or for certain benefit.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
string <uuid>

The id of the location

benefitRef
string <uuid>

The id of the benefit

Responses

Response samples

Content type
application/json
{
  • "benefitApplications": [
    ]
}

Companies

"Company" resource represents a company in a certain location.

Retrieve companies

Retrieve all companies.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "id:asc"

The order of filtered items. Format - field:order. Possible field values are createDate, id, title. Order values - asc, desc.

title
string

Filter by company's title

Responses

Response samples

Content type
application/json
{
  • "companies": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "links": {}
}

Create a company

Create a company.

Authorizations:
OAuth2ClientCredentials
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "company": {
    }
}

Response samples

Content type
application/json
{
  • "company": {
    }
}

Retrieve a company

Retrieve a certain company.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of company.

Responses

Response samples

Content type
application/json
{
  • "company": {
    }
}

Update a company

Update a certain company.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of the company.

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "company": {
    }
}

Response samples

Content type
application/json
{
  • "company": {
    }
}

Create a subscription

Create a subscription to a certain company.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of the company.

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "plan": {
    }
}

Response samples

Content type
application/json
{
  • "company": {
    }
}

Desk Bookings

Spacebring allows to book desks. "Desk Booking" resource represents a booking of a desk in a certain location.

Retrieve desk bookings

Retrieve all bookings for a certain desk.

Authorizations:
OAuth2ClientCredentials
query Parameters
deskRef
string <uuid>

The id of the desk. Required if organizationRef is not passed.

organizationRef
string <uuid>

The id of the organization. Required if deskRef is not passed.

userRef
integer <int64>

The id of the user

string or object

The date filter of items.

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "date:asc"

The order of filtered items. Format - field:order. Possible field values are date, createDate, id. Order values - asc, desc.

Responses

Response samples

Content type
application/json
{
  • "deskBookings": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "total": 0,
  • "links": {}
}

Create desk booking

Create a desk booking.

Authorizations:
OAuth2ClientCredentials
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "deskBooking": {
    }
}

Response samples

Content type
application/json
{
  • "deskBooking": {
    }
}

Delete desk booking

Delete a desk booking.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of the desk booking.

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Desks

Spacebring allows to book desks. "Desk" resource represents an actual desk in a certain location.

Retrieve desks

Retrieve desks in the organization.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization.

date
string <date>
Deprecated

Get desks available for booking.

Responses

Response samples

Content type
application/json
{
  • "desks": [
    ]
}

Event Tickets

Spacebring allows to organize events. When users join events, they get an event ticket. The "Event Ticket" resource represents a ticket for an event in a certain location.

Retrieve event tickets

Retrieve all event tickets.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization.

Responses

Response samples

Content type
application/json
{
  • "eventPasses": [
    ]
}

Feed Posts

Spacebring has a community feed called Feed. Users can create posts on Feed. The "Feed Post" resource represents a post on Feed in a certain location.

Create a Feed post

Create a Feed post.

Authorizations:
OAuth2
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "activity": {
    }
}

Response samples

Content type
application/json
{
  • "activity": {
    }
}

Invoices

Spacebring has a built-in invoicing system. The "Invoice" resource represents an invoice issued for a member or a company in a certain location.

Retrieve invoices

Retrieve all invoices based on certain parameters.

Authorizations:
OAuth2ClientCredentials
query Parameters
companyRef
string <uuid>

The id of the company

membershipRef
integer <int64>

The id of the membership

organizationRef
string <uuid>

The id of the organization

object

The readyDate filter of items.

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "id:asc"

The order of filtered items. Format - field:order. Possible field values are createDate, id, readyDate. Order values - asc, desc.

status
string
Enum: "active" "inactive" "ready" "voided"

The status of an invoice.

Responses

Response samples

Content type
application/json
{
  • "bills": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "links": {}
}

Create an invoice

Create an invoice for a member or a company.

Authorizations:
OAuth2
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "bill": {
    }
}

Response samples

Content type
application/json
{
  • "bill": {
    }
}

Retrieve an invoice

Retrieve a certain invoice.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of an invoice.

Responses

Response samples

Content type
application/json
{
  • "bill": {
    }
}

Pay an invoice with a given id

Mark an invoice as paid by "External Payment." Learn more about External Payment

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of an invoice

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "payment": {
    }
}

Response samples

Content type
application/json
{
  • "transaction": {
    }
}

Invoice Items

"Invoice Item" resource represents an item of an invoice.

Create a invoice item

Create an item in an invoice.

Authorizations:
OAuth2
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "billItem": {
    }
}

Response samples

Content type
application/json
{
  • "billItem": {
    }
}

Locations

Spacebring supports multiple locations. The "Location" resource represents a location on Spacebring.

Retrieve all locations.

Authorizations:
OAuth2ClientCredentials
query Parameters
networkRef
string <uuid>

The id of the network.

role
string
Enum: "admin" "member"

Filter by user permission in organization.

Responses

Response samples

Content type
application/json
{
  • "organizations": [
    ]
}

Membership Requests

When users request to join a certain location, Spacebring creates a request for administrators to approve or reject. The "Membership Request" resource represents such a request to join a certain location.

Retrieve requests to join

Retrieve requests to join the organization.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization.

Responses

Response samples

Content type
application/json
{
  • "membershipRequests": [
    ]
}

Memberships

When users join a certain location, they obtain membership there (become members). The "Membership" resource represents a mutual connection between a member and a certain location.

Retrieve memberships

Retrieve all memberships.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "id:asc"

The order of filtered items. Format - field:order. Possible field values are createDate, deleteDate, id, invitationDate. Order values - asc, desc.

userEmail
string <email>

Filter by user's email

Responses

Response samples

Content type
application/json
{
  • "memberships": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "links": {}
}

Create a membership

Create a membership and send an email invitation to join.

Authorizations:
OAuth2ClientCredentials
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "membership": {
    }
}

Response samples

Content type
application/json
{
  • "membership": {
    }
}

Retrieve deleted memberships

Retrieve all deleted memberships.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "id:asc"

The order of filtered items. Format - field:order. Possible field values are createDate, deleteDate, id, invitationDate. Order values - asc, desc.

userEmail
string <email>

Filter by user's email

Responses

Response samples

Content type
application/json
{
  • "memberships": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "links": {}
}

Retrieve a membership

Retrieve a certain membership.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
integer <int64>

The id of membership.

Responses

Response samples

Content type
application/json
{
  • "membership": {
    }
}

Delete a membership

Delete a certain membership.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
integer <int64>

The id of the membership.

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Update a membership

Update a certain membership.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
integer <int64>

The id of the membership.

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "membership": {
    }
}

Response samples

Content type
application/json
{
  • "membership": {
    }
}

Create a subscription

Create a subscription to a certain membership.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
number

The id of the membership.

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "plan": {
    }
}

Response samples

Content type
application/json
{
  • "membership": {
    }
}

Networks

Spacebring allows users to join multiple locations. The "Network" resource represents a network of locations that a user is a member of.

Retrieve networks

Retrieve all networks you are in.

Authorizations:
OAuth2ClientCredentials

Responses

Response samples

Content type
application/json
{
  • "networks": [
    ]
}

Retrieve registrations

Retrieve all registrations in network.

Authorizations:
OAuth2ClientCredentials
query Parameters
networkRef
required
string <uuid>

The id of the network

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

Responses

Response samples

Content type
application/json
{
  • "registrations": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "links": {}
}

Orders

Spacebring allows users to buy products in shop. The "Order" resource represents an actual order for a certain product in shop.

Retrieve orders

Retrieve all orders.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization

userRef
integer <int64>

The id of the user

object

The date filter of items.

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "createDate:asc"

The order of filtered items. Format - field:order. Possible field values are createDate, id. Order values - asc, desc.

Responses

Response samples

Content type
application/json
{
  • "orders": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "total": 0,
  • "links": {}
}

Products

Spacebring allows users to buy products in shop. The "Products" resource represents an actual product in a certain location.

Retrieve products

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the location.

Responses

Response samples

Content type
application/json
{
  • "products": [
    ]
}

Update a product

Update a certain product.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of the product.

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "product": {
    }
}

Response samples

Content type
application/json
{
  • "product": {
    }
}

Room Bookings

Spacebring allows users to book meeting rooms. The "Room Booking" resource represents a booking of a room in a certain location.

Retrieve room bookings

Retrieve all room bookings for a certain room.

Authorizations:
OAuth2ClientCredentials
query Parameters
roomRef
string <uuid>

The id of the room. Required if organizationRef is not passed.

organizationRef
string <uuid>

The id of the organization. Required if roomRef is not passed.

userRef
integer <int64>

The id of the user

object

The date filter of items.

object

The date filter of items.

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "endDate:asc"

The order of filtered items. Format - field:order. Possible field values are createDate, endDate, startDate, id. Order values - asc, desc.

Responses

Response samples

Content type
application/json
{
  • "roomBooking": [
    ],
  • "limit": 0,
  • "offset": 0,
  • "total": 0,
  • "links": {}
}

Create room booking

Create a room booking in a certain room.

Authorizations:
OAuth2ClientCredentials
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "roomBooking": {
    }
}

Response samples

Content type
application/json
{
  • "roomBooking": {
    }
}

Delete room booking

Delete a room booking.

Authorizations:
OAuth2ClientCredentials
path Parameters
id
required
string <uuid>

The id of the room booking.

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Rooms

Spacebring allows users to book meeting rooms. The "Room" resource represents an actual meeting room in a certain location.

Retrieve rooms

Retrieve rooms in the organization.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization.

startDate
string <date-time>
Deprecated

Get rooms available for booking. Required if endDate is defined.

endDate
string <date-time>
Deprecated

Get rooms available for booking. Required if startDate is defined.

Responses

Response samples

Content type
application/json
{
  • "rooms": [
    ]
}

Tickets

Spacebring allows users to report issues to administrators. The "Ticket" resource represents a support ticket in a certain location.

Retrieve tickets

Retrieve all tickets.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization.

offset
integer <int64> >= 0
Default: 0

The number of items to skip before starting to collect the result set

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

order
string
Default: "createDate:desc"

The order of filtered items. Format - field:order. Possible field values are createDate, updateDate. Order values - asc, desc.

Responses

Response samples

Content type
application/json
{
  • "limit": 0,
  • "offset": 0,
  • "total": 0,
  • "links": {},
  • "tickets": [
    ]
}

Transactions

When users pay for something on Spacebring, a corresponding transaction is created. The "Transaction" resource represents a payment in a certain location.

Retrieve money transactions

Retrieve money transactions.

Authorizations:
OAuth2ClientCredentials
query Parameters
organizationRef
required
string <uuid>

The id of the organization

limit
integer <int64> [ 1 .. 100 ]
Default: 25

The number of items to return

paymentStatus
string
Enum: "canceled" "failed" "pending" "succeeded"

The payment status of transactions

object

The date filter of items

Responses

Response samples

Content type
application/json
{
  • "transactions": [
    ],
  • "links": {
    }
}

Users

The "User" resource represents a user of your application. Users can perform a variety of actions on Spacebring, such as making a booking, purchase an event ticket, request to join a location, and more.

Search user

Retrieve user by email.

Authorizations:
OAuth2ClientCredentials
query Parameters
email
required
string

The email of user to search.

Responses

Response samples

Content type
application/json
{
  • "users": [
    ]
}

Visits

Spacebring allows members to register visitors. The "Visit" resource represents a preliminary registration of a visit in a certain location.

Create a visit

Create a visit.

Authorizations:
OAuth2
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "visit": {
    }
}

Response samples

Content type
application/json
{
  • "visit": {
    }
}