HSDA

The core HSDA protocol is defined by openapi-hsda.yaml. The details below show the available methods and responses.

You can also explore this using our OpenAPI viewer.

General principles

  • Applications should always support GET, but may choose whether or not to support POST. PUT and DELETE requests;

  • Each resource is named after a table in HSDS, and field names and definitions follow HSDS definitions;

  • Most resources have a /complete/ version which should be populated with content from linked tables to provide consumers with access to contextually relevant data;

GET /contacts/

Get all contacts

Returns a list of all registered contacts with filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

POST /contacts/

Add contact

Creates a new named contact entry for services or organizations

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /contacts/complete/

Get all contacts with full details

Returns a list of contacts with full details and filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

POST /contacts/complete/

Add contact with full details

Creates a new contact entry with full details

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /contacts/complete/{contact_id}/

Get contact with full details

Returns a contact entry with full details

Parameters
  • contact_id (string) – The contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

PUT /contacts/complete/{contact_id}/

Update contact with full details

Updates a contact entry with full details

Parameters
  • contact_id (string) – The contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

DELETE /contacts/complete/{contact_id}/

Delete contact with full details

Deletes a contact entry with full details

Parameters
  • contact_id (string) – The contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /contacts/{contact_id}/

Get contact

Returns a contact entry by its Id

Parameters
  • contact_id (string) – The contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

PUT /contacts/{contact_id}/

Update a contact

Updates an existing contact by Id

Parameters
  • contact_id (string) – The contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

DELETE /contacts/{contact_id}/

Delete contact

Deletes a contact by Id

Parameters
  • contact_id (string) – The contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /contacts/{contact_id}/phones/

Get all phones for contact

Returns a list of phones associated with a specific contact

Parameters
  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

POST /contacts/{contact_id}/phones/

Add phone for contact

Adds a new phone that is associated with a specific contact Id

Parameters
  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /contacts/{contact_id}/phones/{phone_id}/

Get phone for contact

Returns the specific phone entity associated with a specific contact

Parameters
  • contact_id (string) – The unique contact id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

PUT /contacts/{contact_id}/phones/{phone_id}/

Update phone for contact

Updates an existing contact’s phone entry

Parameters
  • contact_id (string) – The unique contact id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

DELETE /contacts/{contact_id}/phones/{phone_id}/

Delete phone for contact

Deletes a specific phone instance associated with a specific contact Id

Parameters
  • contact_id (string) – The unique contact id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /locations/

Get all locations

Returns a list of locations with filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Amount of locations to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

POST /locations/

Add location

Creates a new location entry

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

GET /locations/complete/

Get all locations with full details

Returns a list of locations with full details and filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

False

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

postal_address/0/id

Each postal address must have a unique identifier.

string

True

postal_address/0/location_id

The identifier of the location for which this is the postal address.

string

False

postal_address/0/attention

The person or entity for whose attention mail should be marked.

string

False

postal_address/0/address_1

The first line of the address.

string

False

postal_address/0/address_2

The second line of the address.

string

False

postal_address/0/address_3

The third line of the address.

string

False

postal_address/0/address_4

The fourth line of the address.

string

False

postal_address/0/city

The city in which the address is located.

string

False

postal_address/0/region

The region in which the address is located (optional).

string

False

postal_address/0/state_province

The state or province in which the address is located.

string

False

postal_address/0/postal_code

The postal code for the address.

string

False

postal_address/0/country

The country in which the address is located.

string

False

physical_address/0/id

Each physical address must have a unique identifier.

string

True

physical_address/0/location_id

The identifier of the location for which this is the address.

string

False

physical_address/0/attention

The person or entity whose attention should be sought at the location.

string

False

physical_address/0/address_1

The first line of the address.

string

True

physical_address/0/address_2

The second line of the address.

string

False

physical_address/0/address_3

The third line of the address.

string

False

physical_address/0/address_4

The fourth line of the address.

string

False

physical_address/0/city

The city in which the address is located.

string

True

physical_address/0/region

The region in which the address is located (optional).

string

False

physical_address/0/state_province

The state or province in which the address is located.

string

True

physical_address/0/postal_code

The postal code for the address.

string

True

physical_address/0/country

The country in which the address is located. This should be given as an ISO 3361-1 country code (two letter abbreviation).

string

True

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

service/0/id

Each service must have a unique identifier.

string

False

service/0/organization_id

The identifier of the organization that provides this service.

string

False

service/0/program_id

The identifier of the program this service is delivered under.

string

False

service/0/location_id

The identifier of the location where this service is delivered.

string

False

service/0/name

The official or public name of the service.

string

False

service/0/alternate_name

Alternative or commonly used name for a service.

string

False

service/0/description

A description of the service.

string

False

service/0/url

URL of the service.

string

False

service/0/email

Email address for the service.

string

False

service/0/status

The current status of the service.

string

False

service/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

service/0/application_process

The steps needed to access the service.

string

False

service/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

service/0/fees

Details of any charges for service users to access this service.

string

False

service/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

service/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

accessibility_for_disabilities/0/id

Each entry must have a unique identifier.

string

True

accessibility_for_disabilities/0/location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility_for_disabilities/0/accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

accessibility_for_disabilities/0/details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

POST /locations/complete/

Add location with full details

Creates a new location entry with full details

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

False

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

postal_address/0/id

Each postal address must have a unique identifier.

string

True

postal_address/0/location_id

The identifier of the location for which this is the postal address.

string

False

postal_address/0/attention

The person or entity for whose attention mail should be marked.

string

False

postal_address/0/address_1

The first line of the address.

string

False

postal_address/0/address_2

The second line of the address.

string

False

postal_address/0/address_3

The third line of the address.

string

False

postal_address/0/address_4

The fourth line of the address.

string

False

postal_address/0/city

The city in which the address is located.

string

False

postal_address/0/region

The region in which the address is located (optional).

string

False

postal_address/0/state_province

The state or province in which the address is located.

string

False

postal_address/0/postal_code

The postal code for the address.

string

False

postal_address/0/country

The country in which the address is located.

string

False

physical_address/0/id

Each physical address must have a unique identifier.

string

True

physical_address/0/location_id

The identifier of the location for which this is the address.

string

False

physical_address/0/attention

The person or entity whose attention should be sought at the location.

string

False

physical_address/0/address_1

The first line of the address.

string

True

physical_address/0/address_2

The second line of the address.

string

False

physical_address/0/address_3

The third line of the address.

string

False

physical_address/0/address_4

The fourth line of the address.

string

False

physical_address/0/city

The city in which the address is located.

string

True

physical_address/0/region

The region in which the address is located (optional).

string

False

physical_address/0/state_province

The state or province in which the address is located.

string

True

physical_address/0/postal_code

The postal code for the address.

string

True

physical_address/0/country

The country in which the address is located. This should be given as an ISO 3361-1 country code (two letter abbreviation).

string

True

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

service/0/id

Each service must have a unique identifier.

string

False

service/0/organization_id

The identifier of the organization that provides this service.

string

False

service/0/program_id

The identifier of the program this service is delivered under.

string

False

service/0/location_id

The identifier of the location where this service is delivered.

string

False

service/0/name

The official or public name of the service.

string

False

service/0/alternate_name

Alternative or commonly used name for a service.

string

False

service/0/description

A description of the service.

string

False

service/0/url

URL of the service.

string

False

service/0/email

Email address for the service.

string

False

service/0/status

The current status of the service.

string

False

service/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

service/0/application_process

The steps needed to access the service.

string

False

service/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

service/0/fees

Details of any charges for service users to access this service.

string

False

service/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

service/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

accessibility_for_disabilities/0/id

Each entry must have a unique identifier.

string

True

accessibility_for_disabilities/0/location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility_for_disabilities/0/accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

accessibility_for_disabilities/0/details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

GET /locations/complete/{location_id}/

Get location with full details

Returns a location entry with full details

Parameters
  • location_id (string) – The location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

False

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

postal_address/0/id

Each postal address must have a unique identifier.

string

True

postal_address/0/location_id

The identifier of the location for which this is the postal address.

string

False

postal_address/0/attention

The person or entity for whose attention mail should be marked.

string

False

postal_address/0/address_1

The first line of the address.

string

False

postal_address/0/address_2

The second line of the address.

string

False

postal_address/0/address_3

The third line of the address.

string

False

postal_address/0/address_4

The fourth line of the address.

string

False

postal_address/0/city

The city in which the address is located.

string

False

postal_address/0/region

The region in which the address is located (optional).

string

False

postal_address/0/state_province

The state or province in which the address is located.

string

False

postal_address/0/postal_code

The postal code for the address.

string

False

postal_address/0/country

The country in which the address is located.

string

False

physical_address/0/id

Each physical address must have a unique identifier.

string

True

physical_address/0/location_id

The identifier of the location for which this is the address.

string

False

physical_address/0/attention

The person or entity whose attention should be sought at the location.

string

False

physical_address/0/address_1

The first line of the address.

string

True

physical_address/0/address_2

The second line of the address.

string

False

physical_address/0/address_3

The third line of the address.

string

False

physical_address/0/address_4

The fourth line of the address.

string

False

physical_address/0/city

The city in which the address is located.

string

True

physical_address/0/region

The region in which the address is located (optional).

string

False

physical_address/0/state_province

The state or province in which the address is located.

string

True

physical_address/0/postal_code

The postal code for the address.

string

True

physical_address/0/country

The country in which the address is located. This should be given as an ISO 3361-1 country code (two letter abbreviation).

string

True

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

service/0/id

Each service must have a unique identifier.

string

False

service/0/organization_id

The identifier of the organization that provides this service.

string

False

service/0/program_id

The identifier of the program this service is delivered under.

string

False

service/0/location_id

The identifier of the location where this service is delivered.

string

False

service/0/name

The official or public name of the service.

string

False

service/0/alternate_name

Alternative or commonly used name for a service.

string

False

service/0/description

A description of the service.

string

False

service/0/url

URL of the service.

string

False

service/0/email

Email address for the service.

string

False

service/0/status

The current status of the service.

string

False

service/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

service/0/application_process

The steps needed to access the service.

string

False

service/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

service/0/fees

Details of any charges for service users to access this service.

string

False

service/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

service/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

accessibility_for_disabilities/0/id

Each entry must have a unique identifier.

string

True

accessibility_for_disabilities/0/location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility_for_disabilities/0/accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

accessibility_for_disabilities/0/details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

PUT /locations/complete/{location_id}/

Update location with full details

Updates a location entry with full details

Parameters
  • location_id (string) – The location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

False

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

postal_address/0/id

Each postal address must have a unique identifier.

string

True

postal_address/0/location_id

The identifier of the location for which this is the postal address.

string

False

postal_address/0/attention

The person or entity for whose attention mail should be marked.

string

False

postal_address/0/address_1

The first line of the address.

string

False

postal_address/0/address_2

The second line of the address.

string

False

postal_address/0/address_3

The third line of the address.

string

False

postal_address/0/address_4

The fourth line of the address.

string

False

postal_address/0/city

The city in which the address is located.

string

False

postal_address/0/region

The region in which the address is located (optional).

string

False

postal_address/0/state_province

The state or province in which the address is located.

string

False

postal_address/0/postal_code

The postal code for the address.

string

False

postal_address/0/country

The country in which the address is located.

string

False

physical_address/0/id

Each physical address must have a unique identifier.

string

True

physical_address/0/location_id

The identifier of the location for which this is the address.

string

False

physical_address/0/attention

The person or entity whose attention should be sought at the location.

string

False

physical_address/0/address_1

The first line of the address.

string

True

physical_address/0/address_2

The second line of the address.

string

False

physical_address/0/address_3

The third line of the address.

string

False

physical_address/0/address_4

The fourth line of the address.

string

False

physical_address/0/city

The city in which the address is located.

string

True

physical_address/0/region

The region in which the address is located (optional).

string

False

physical_address/0/state_province

The state or province in which the address is located.

string

True

physical_address/0/postal_code

The postal code for the address.

string

True

physical_address/0/country

The country in which the address is located. This should be given as an ISO 3361-1 country code (two letter abbreviation).

string

True

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

service/0/id

Each service must have a unique identifier.

string

False

service/0/organization_id

The identifier of the organization that provides this service.

string

False

service/0/program_id

The identifier of the program this service is delivered under.

string

False

service/0/location_id

The identifier of the location where this service is delivered.

string

False

service/0/name

The official or public name of the service.

string

False

service/0/alternate_name

Alternative or commonly used name for a service.

string

False

service/0/description

A description of the service.

string

False

service/0/url

URL of the service.

string

False

service/0/email

Email address for the service.

string

False

service/0/status

The current status of the service.

string

False

service/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

service/0/application_process

The steps needed to access the service.

string

False

service/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

service/0/fees

Details of any charges for service users to access this service.

string

False

service/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

service/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

accessibility_for_disabilities/0/id

Each entry must have a unique identifier.

string

True

accessibility_for_disabilities/0/location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility_for_disabilities/0/accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

accessibility_for_disabilities/0/details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

GET /locations/{location_id}/

Get location

Returns a location entry by Id

Parameters
  • location_id (string) – The location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

PUT /locations/{location_id}/

Update location

Updates a location entry

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

DELETE /locations/{location_id}/

Delete location

Deletes a location entry

Parameters
  • location_id (string) – The location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

GET /locations/{location_id}/holiday-schedule/

Get all holiday schedules for a location

Returns the list of holiday schedules for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

POST /locations/{location_id}/holiday-schedule/

Add holiday schedule for location

Creates a new holiday schedule entry for a location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

GET /locations/{location_id}/holiday-schedule/{holiday_schedule_id}/

Get holiday schedule for location

Returns a specific holiday schedule for a location by Id

Parameters
  • location_id (string) – The unique location id.

  • holiday_schedule_id (string) – The unique holiday schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

PUT /locations/{location_id}/holiday-schedule/{holiday_schedule_id}/

Update holiday schedule for location

Updates a holiday schedule entry for a location

Parameters
  • location_id (string) – The unique location id.

  • holiday_schedule_id (string) – The unique holiday schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

DELETE /locations/{location_id}/holiday-schedule/{holiday_schedule_id}/

Delete holiday schedule for location

Deletes a holiday schedule entry for a location

Parameters
  • location_id (string) – The unique location id.

  • holiday_schedule_id (string) – The unique holiday schdule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

GET /locations/{location_id}/languages/

Get all languages for a location

Returns a list of all languages supported by a location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

POST /locations/{location_id}/languages/

Add language for location

Adds a new language entry for a location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

GET /locations/{location_id}/languages/{language_id}/

Get language for location

Returns a specific language entry for a specific location by Id

Parameters
  • location_id (string) – The unique location id.

  • language_id (string) – The unique language id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

PUT /locations/{location_id}/languages/{language_id}/

Update a language for a location

Updates a language entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • language_id (string) – The unique language id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

DELETE /locations/{location_id}/languages/{language_id}/

Delete language for location

Deletes a language entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • language_id (string) – The unique language id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

GET /locations/{location_id}/postal-address/

Get all postal addresses of a location

Returns a list of postal addresses for a location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

POST /locations/{location_id}/postal-address/

Add postal address for location

Creates a new postal address for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

GET /locations/{location_id}/postal-address/{postal_address_id}/

Get postal address for location

Returns a postal address entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • postal_address_id (string) – The unique postal address id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

PUT /locations/{location_id}/postal-address/{postal_address_id}/

Update postal address for location

Updates a postal address entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • postal_address_id (string) – The unique postal address id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

DELETE /locations/{location_id}/postal-address/{postal_address_id}/

Delete postal address for location

Deletes a postal adress entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • postal_address_id (string) – The unique postal address id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

GET /locations/{location_id}/physical-address/

Get physical addresses for location

Returns a list of physical addresses for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

POST /locations/{location_id}/physical-address/

Add physical address for location

Creates a new phsycial address entry for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

GET /locations/{location_id}/physical-address/{postal_address_id}/

Get physical address for location

Returns a physical address entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • postal_address_id (string) – The unique postal address id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

PUT /locations/{location_id}/physical-address/{postal_address_id}/

Update physical address for location

Updates a physical address entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • postal_address_id (string) – The unique postal address id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

DELETE /locations/{location_id}/physical-address/{postal_address_id}/

Delete a physical address for a location

Deletes a phsysical address entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • postal_address_id (string) – The unique postal address id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each postal address must have a unique identifier.

string

True

location_id

The identifier of the location for which this is the postal address.

string

False

attention

The person or entity for whose attention mail should be marked.

string

False

address_1

The first line of the address.

string

False

address_2

The second line of the address.

string

False

address_3

The third line of the address.

string

False

address_4

The fourth line of the address.

string

False

city

The city in which the address is located.

string

False

region

The region in which the address is located (optional).

string

False

state_province

The state or province in which the address is located.

string

False

postal_code

The postal code for the address.

string

False

country

The country in which the address is located.

string

False

GET /locations/{location_id}/phones/

Get all phones for a location

Returns a list of all phones for a location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

POST /locations/{location_id}/phones/

Add phone for location

Creates a new phone entry for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /locations/{location_id}/phones/{phone_id}/

Get phone for location

Returns a phone entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

PUT /locations/{location_id}/phones/{phone_id}/

Update phone for location

Updates a phone entry for a location

Parameters
  • location_id (string) – The unique location id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

DELETE /locations/{location_id}/phones/{phone_id}/

Delete phone for location

Deletes a phone entry for a location

Parameters
  • location_id (string) – The unique location id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /locations/{location_id}/regular-schedule/

Get all regular schedules for a location

Returns a list of regular schedules for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the regular schedule.

string

False

location_id

The identifier of the location for which this is the regular schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

weekday

The day of the week that this entry relates to.

string

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

POST /locations/{location_id}/regular-schedule/

Add regular schedule for location

Creates a regular schedule entry for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the regular schedule.

string

False

location_id

The identifier of the location for which this is the regular schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

weekday

The day of the week that this entry relates to.

string

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

GET /locations/{location_id}/regular-schedule/{regular_schedule_id}/

Get regular schedule for location

Returns a regular schedule entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • regular_schedule_id (string) – The unique regular schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the regular schedule.

string

False

location_id

The identifier of the location for which this is the regular schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

weekday

The day of the week that this entry relates to.

string

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

PUT /locations/{location_id}/regular-schedule/{regular_schedule_id}/

Update regular schedule for location

Updates a regular schedule entry for a location

Parameters
  • location_id (string) – The unique location id.

  • regular_schedule_id (string) – The unique regular schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the regular schedule.

string

False

location_id

The identifier of the location for which this is the regular schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

weekday

The day of the week that this entry relates to.

string

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

DELETE /locations/{location_id}/regular-schedule/{regular_schedule_id}/

Delete regular schedule for location

Deletes a regular schedule entry for a location

Parameters
  • location_id (string) – The unique location id.

  • regular_schedule_id (string) – The unique regular schedule id.

Status Codes
  • 200 OK – Regular Schedule Response

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the regular schedule.

string

False

location_id

The identifier of the location for which this is the regular schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

weekday

The day of the week that this entry relates to.

string

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

GET /locations/{location_id}/services/

Get all services for location

Returns a list of all services for a location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

POST /locations/{location_id}/services/

Add service for location

Creates a new service entry for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /locations/{location_id}/services/{service_id}/

Get service for location

Returns a service entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

PUT /locations/{location_id}/services/{service_id}/

Update service for location

Updates a service entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

DELETE /locations/{location_id}/services/{service_id}/

Delete service for location

Deletes a service entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /locations/{location_id}/accessibility/

Get list of accessibility for disabilities for location

Returns a list of all accessibility for disabilities for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

POST /locations/{location_id}/accessibility/

Add accessibility for disabilities for location

Creates a new accessibility for disabilities entry for a specific location

Parameters
  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

GET /locations/{location_id}/accessibility/{accessibility_id}/

Get accessibility for disabilities for location

Returns an accessibility for disabilities entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • accessibility_id (string) – The unique accessibility for disabilities id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

PUT /locations/{location_id}/accessibility/{accessibility_id}/

Update accessibility for disabilities for location

Updates an existing accessibility for disabilities for a specific location

Parameters
  • location_id (string) – The unique location id.

  • accessibility_id (string) – The unique accessibility for disabilities id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

DELETE /locations/{location_id}/accessibility/{accessibility_id}/

Delete accessibility for disabilities for location

Deletes an accessibility for disabilities entry for a specific location

Parameters
  • location_id (string) – The unique location id.

  • accessibility_id (string) – The unique accessibility for disabilities id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location for which the entry describes the accessibility provision.

string

False

accessibility

Description of assistance or infrastructure that facilitate access to clients with disabilities.

string

False

details

Any further details relating to the relevant accessibility arrangements at this location. E.g. whether advance notice is required to use an accessibility facility.

string

False

GET /organizations/

Get list of organizations

Returns a list of all organizations with filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdown.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

POST /organizations/

Add organization

Creates a new organization entry

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdown.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

GET /organizations/complete/

Get list of organizations with full details

Returns a list of organizations with full schema and filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdow.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

locations/0/id

Each location must have a unique identifier.

string

True

locations/0/organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

locations/0/name

The name of the location.

string

True

locations/0/alternate_name

An alternative name for the location.

string

False

locations/0/description

A description of this location.

string

False

locations/0/transportation

A description of the access to public or private transportation to and from the location.

string

False

locations/0/latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

locations/0/longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

programs/0/id

Each program must have a unique identifier.

string

True

programs/0/organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

programs/0/name

The name of the program.

string

True

programs/0/alternate_name

NeAn alternative name for the program.

string

False

services/0/id

Each service must have a unique identifier.

string

False

services/0/organization_id

The identifier of the organization that provides this service.

string

False

services/0/program_id

The identifier of the program this service is delivered under.

string

False

services/0/location_id

The identifier of the location where this service is delivered.

string

False

services/0/name

The official or public name of the service.

string

False

services/0/alternate_name

Alternative or commonly used name for a service.

string

False

services/0/description

A description of the service.

string

False

services/0/url

URL of the service.

string

False

services/0/email

Email address for the service.

string

False

services/0/status

The current status of the service.

string

False

services/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

services/0/application_process

The steps needed to access the service.

string

False

services/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

services/0/fees

Details of any charges for service users to access this service.

string

False

services/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

services/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

POST /organizations/complete/

Add organization with full details

Creates a new organization entry with full details

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdow.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

locations/0/id

Each location must have a unique identifier.

string

True

locations/0/organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

locations/0/name

The name of the location.

string

True

locations/0/alternate_name

An alternative name for the location.

string

False

locations/0/description

A description of this location.

string

False

locations/0/transportation

A description of the access to public or private transportation to and from the location.

string

False

locations/0/latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

locations/0/longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

programs/0/id

Each program must have a unique identifier.

string

True

programs/0/organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

programs/0/name

The name of the program.

string

True

programs/0/alternate_name

NeAn alternative name for the program.

string

False

services/0/id

Each service must have a unique identifier.

string

False

services/0/organization_id

The identifier of the organization that provides this service.

string

False

services/0/program_id

The identifier of the program this service is delivered under.

string

False

services/0/location_id

The identifier of the location where this service is delivered.

string

False

services/0/name

The official or public name of the service.

string

False

services/0/alternate_name

Alternative or commonly used name for a service.

string

False

services/0/description

A description of the service.

string

False

services/0/url

URL of the service.

string

False

services/0/email

Email address for the service.

string

False

services/0/status

The current status of the service.

string

False

services/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

services/0/application_process

The steps needed to access the service.

string

False

services/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

services/0/fees

Details of any charges for service users to access this service.

string

False

services/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

services/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /organizations/complete/{organization_id}/

Get organization with full details

Returns an organization entry with full details by Id

Parameters
  • organization_id (string) – The organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdow.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

locations/0/id

Each location must have a unique identifier.

string

True

locations/0/organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

locations/0/name

The name of the location.

string

True

locations/0/alternate_name

An alternative name for the location.

string

False

locations/0/description

A description of this location.

string

False

locations/0/transportation

A description of the access to public or private transportation to and from the location.

string

False

locations/0/latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

locations/0/longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

programs/0/id

Each program must have a unique identifier.

string

True

programs/0/organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

programs/0/name

The name of the program.

string

True

programs/0/alternate_name

NeAn alternative name for the program.

string

False

services/0/id

Each service must have a unique identifier.

string

False

services/0/organization_id

The identifier of the organization that provides this service.

string

False

services/0/program_id

The identifier of the program this service is delivered under.

string

False

services/0/location_id

The identifier of the location where this service is delivered.

string

False

services/0/name

The official or public name of the service.

string

False

services/0/alternate_name

Alternative or commonly used name for a service.

string

False

services/0/description

A description of the service.

string

False

services/0/url

URL of the service.

string

False

services/0/email

Email address for the service.

string

False

services/0/status

The current status of the service.

string

False

services/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

services/0/application_process

The steps needed to access the service.

string

False

services/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

services/0/fees

Details of any charges for service users to access this service.

string

False

services/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

services/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

PUT /organizations/complete/{organization_id}/

Update organization with full details

Updates an organization entry with full details

Parameters
  • organization_id (string) – The organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdow.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

locations/0/id

Each location must have a unique identifier.

string

True

locations/0/organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

locations/0/name

The name of the location.

string

True

locations/0/alternate_name

An alternative name for the location.

string

False

locations/0/description

A description of this location.

string

False

locations/0/transportation

A description of the access to public or private transportation to and from the location.

string

False

locations/0/latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

locations/0/longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

programs/0/id

Each program must have a unique identifier.

string

True

programs/0/organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

programs/0/name

The name of the program.

string

True

programs/0/alternate_name

NeAn alternative name for the program.

string

False

services/0/id

Each service must have a unique identifier.

string

False

services/0/organization_id

The identifier of the organization that provides this service.

string

False

services/0/program_id

The identifier of the program this service is delivered under.

string

False

services/0/location_id

The identifier of the location where this service is delivered.

string

False

services/0/name

The official or public name of the service.

string

False

services/0/alternate_name

Alternative or commonly used name for a service.

string

False

services/0/description

A description of the service.

string

False

services/0/url

URL of the service.

string

False

services/0/email

Email address for the service.

string

False

services/0/status

The current status of the service.

string

False

services/0/interpretation_services

A description of any interpretation services available for accessing this service.

string

False

services/0/application_process

The steps needed to access the service.

string

False

services/0/wait_time

Time a client may expect to wait before receiving a service.

string

False

services/0/fees

Details of any charges for service users to access this service.

string

False

services/0/accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

services/0/licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /organizations/{organization_id}/

Get organization

Returns a specific organization entry by Id

Parameters
  • organization_id (string) – The organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdown.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

PUT /organizations/{organization_id}/

Update organization

Updates an organization entry

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdown.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

DELETE /organizations/{organization_id}/

Delete organization

Deletes an organization entry

Parameters
  • organization_id (string) – The organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdown.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

GET /organizations/{organization_id}/contacts/

Get all contacts for organization

Returns a full list of contacts for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

POST /organizations/{organization_id}/contacts/

Add contact for organization

Creates a new contact entry to a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /organizations/{organization_id}/contacts/{contact_id}/

Get contact for organization

Returns a contact entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

PUT /organizations/{organization_id}/contacts/{contact_id}/

Update contact for organization

Updates a contact entry for an organization

Parameters
  • organization_id (string) – The unique organization id.

  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

DELETE /organizations/{organization_id}/contacts/{contact_id}/

Delete contact for organization

Deletes a contact entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /organizations/{organization_id}/funding/

Get funding for organization

Returns a full list of funding entries for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

POST /organizations/{organization_id}/funding/

Add funding for organization

Creates a new funding entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

GET /organizations/{organization_id}/funding/{funding_id}/

Get funding for organization

Returns a funding entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • funding_id (string) – The unique funding id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

PUT /organizations/{organization_id}/funding/{funding_id}/

Update funding for organization

Updates a funding entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • funding_id (string) – The unique funding id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

DELETE /organizations/{organization_id}/funding/{funding_id}/

Delete funding for organization

Deletes a funding entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • funding_id (string) – The unique funding id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

GET /organizations/{organization_id}/locations/

Get all locations for organization

Returns a full list of locations for a specific organization

Parameters
  • organization_id (string) – The id for the organization.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

POST /organizations/{organization_id}/locations/

Add location for organization

Creates a new location entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

GET /organizations/{organization_id}/locations/{location_id}/

Get location for organization

Returns a location entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

PUT /organizations/{organization_id}/locations/{location_id}/

Update location for organization

Updates a location entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

DELETE /organizations/{organization_id}/locations/{location_id}/

Delete location for organization

Deletes a location entry for a specific location

Parameters
  • organization_id (string) – The unique organization id.

  • location_id (string) – The unique location id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each location must have a unique identifier.

string

True

organization_id

Each location must belong to a single organization. The identifier of the organization should be given here.

string

False

name

The name of the location.

string

True

alternate_name

An alternative name for the location.

string

False

description

A description of this location.

string

False

transportation

A description of the access to public or private transportation to and from the location.

string

False

latitude

Y coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

longitude

X coordinate of location expressed in decimal degrees in WGS84 datum.

string

False

GET /organizations/{organization_id}/phones/

Get all phones for organization

Returns a full list of phones for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

POST /organizations/{organization_id}/phones/

Add phone for an organization

Creates a new phone entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /organizations/{organization_id}/phones/{phone_id}/

Get phone for organization

Returns a phone entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

PUT /organizations/{organization_id}/phones/{phone_id}/

Update phone for organization

Updates a phone entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

DELETE /organizations/{organization_id}/phones/{phone_id}/

Delete phone for organization

Deletes a phone entry for an organization

Parameters
  • organization_id (string) – The unique organization id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /organizations/{organization_id}/programs/

Get all programs for organization

Returns a full list of programs for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each program must have a unique identifier.

string

True

organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

name

The name of the program.

string

True

alternate_name

NeAn alternative name for the program.

string

False

POST /organizations/{organization_id}/programs/

Add program for organization

Creates a new program entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each program must have a unique identifier.

string

True

organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

name

The name of the program.

string

True

alternate_name

NeAn alternative name for the program.

string

False

GET /organizations/{organization_id}/programs/{program_id}/

Get program for organization

Returns a program entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each program must have a unique identifier.

string

True

organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

name

The name of the program.

string

True

alternate_name

NeAn alternative name for the program.

string

False

PUT /organizations/{organization_id}/programs/{program_id}/

Update program for organization

Updates a program entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each program must have a unique identifier.

string

True

organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

name

The name of the program.

string

True

alternate_name

NeAn alternative name for the program.

string

False

DELETE /organizations/{organization_id}/programs/{program_id}/

Delete program for organization

Deletes a program entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each program must have a unique identifier.

string

True

organization_id

Each program must belong to a single organization. The identifier of the organization should be given here.

string

True

name

The name of the program.

string

True

alternate_name

NeAn alternative name for the program.

string

False

GET /organizations/{organization_id}/programs/{program_id}/services/

Get all services for a specific program within an organization

Returns a full list of services for a specific program in a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

POST /organizations/{organization_id}/programs/{program_id}/services/

Add service for a program within an organization

Creates a new service entry for a specific program within an organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /organizations/{organization_id}/programs/{program_id}/services/{service_id}/

Get service from a specific program within an organization

Returns a service entry from a specific program within an organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

PUT /organizations/{organization_id}/programs/{program_id}/services/{service_id}/

Update service for a specific program within an organization

Updates a service from a specific program within an organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

DELETE /organizations/{organization_id}/programs/{program_id}/services/{service_id}/

Delete service for a specific program within an organization

Deletes a service from a specific program within an organization

Parameters
  • organization_id (string) – The unique organization id.

  • program_id (string) – The unique program id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /organizations/{organization_id}/services/

Get all services for organization

Returns a full list of services for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

POST /organizations/{organization_id}/services/

Add service for organization

Creates a new service entry for an organization

Parameters
  • organization_id (string) – The unique organization id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /organizations/{organization_id}/services/{service_id}/

Get service for organization

Returns a service entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

PUT /organizations/{organization_id}/services/{service_id}/

Update service for organization

Updates a service entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

DELETE /organizations/{organization_id}/services/{service_id}/

Delete service for organization

Deletes a service entry for a specific organization

Parameters
  • organization_id (string) – The unique organization id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /services/

Get all services

Returns a full list of services with filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

POST /services/

Add service

Creates a new service entry

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /services/complete/

Get all services with full details

Returns a list of services with full details and filtering support

Query Parameters
  • query (string) – A query to filter list by (up to provider to determine what to search)

  • queries (string) – A comma separate list of queries with specific fields.

  • page (number) – The particular page of results.

  • per_page (number) – Number of records to return per page, up to 100.

  • sort_by (string) – Which field to sort by.

  • order (string) – Which order to sort by (asc,desc).

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

True

organization_id

The identifier of the organization that provides this service.

string

True

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

True

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

True

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

eligibility/0/id

Each entry must have a unique identifier.

string

True

eligibility/0/service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility/0/eligibility

The rules or guidelines that determine who can receive the service.

string

False

fees/0/id

Each entry must have a unique identifier.

string

True

fees/0/service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fees/0/fee

A listing of the costs of services, including free ones.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

payment_accepted/0/id

Each entry must have a unique identifier.

string

True

payment_accepted/0/service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment_accepted/0/payment

The methods of payment accepted for the service.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

required_documents/0/id

Each document must have a unique identifier.

string

True

required_documents/0/service_id

The identifier of the service for which this entry describes the required document.

string

False

required_documents/0/document

The document required to apply for or receive the service. e.g. Government-issued ID, EU Passport.

string

False

service_area/0/id

Each service area must have a unique identifier.

string

True

service_area/0/service_id

The identifier of the service for which this entry describes the service area.

string

False

service_area/0/service_area

The geographic area where a service is available. This is a free-text description, and so may be precise or indefinite as necessary.

string

False

service_area/0/description

A more detailed description of this service area. Used to provide any additional information that cannot be communicated using the structured area and geometry fields.

string

False

POST /services/complete/

Add service with full details

Creates a new service entry with full details

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

True

organization_id

The identifier of the organization that provides this service.

string

True

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

True

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

True

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

eligibility/0/id

Each entry must have a unique identifier.

string

True

eligibility/0/service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility/0/eligibility

The rules or guidelines that determine who can receive the service.

string

False

fees/0/id

Each entry must have a unique identifier.

string

True

fees/0/service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fees/0/fee

A listing of the costs of services, including free ones.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

payment_accepted/0/id

Each entry must have a unique identifier.

string

True

payment_accepted/0/service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment_accepted/0/payment

The methods of payment accepted for the service.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

required_documents/0/id

Each document must have a unique identifier.

string

True

required_documents/0/service_id

The identifier of the service for which this entry describes the required document.

string

False

required_documents/0/document

The document required to apply for or receive the service. e.g. Government-issued ID, EU Passport.

string

False

service_area/0/id

Each service area must have a unique identifier.

string

True

service_area/0/service_id

The identifier of the service for which this entry describes the service area.

string

False

service_area/0/service_area

The geographic area where a service is available. This is a free-text description, and so may be precise or indefinite as necessary.

string

False

service_area/0/description

A more detailed description of this service area. Used to provide any additional information that cannot be communicated using the structured area and geometry fields.

string

False

GET /services/complete/{service_id}/

Get service with full details

Returns a service entry with full details

Parameters
  • service_id (string) – The service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

True

organization_id

The identifier of the organization that provides this service.

string

True

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

True

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

True

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

eligibility/0/id

Each entry must have a unique identifier.

string

True

eligibility/0/service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility/0/eligibility

The rules or guidelines that determine who can receive the service.

string

False

fees/0/id

Each entry must have a unique identifier.

string

True

fees/0/service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fees/0/fee

A listing of the costs of services, including free ones.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

payment_accepted/0/id

Each entry must have a unique identifier.

string

True

payment_accepted/0/service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment_accepted/0/payment

The methods of payment accepted for the service.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

required_documents/0/id

Each document must have a unique identifier.

string

True

required_documents/0/service_id

The identifier of the service for which this entry describes the required document.

string

False

required_documents/0/document

The document required to apply for or receive the service. e.g. Government-issued ID, EU Passport.

string

False

service_area/0/id

Each service area must have a unique identifier.

string

True

service_area/0/service_id

The identifier of the service for which this entry describes the service area.

string

False

service_area/0/service_area

The geographic area where a service is available. This is a free-text description, and so may be precise or indefinite as necessary.

string

False

service_area/0/description

A more detailed description of this service area. Used to provide any additional information that cannot be communicated using the structured area and geometry fields.

string

False

PUT /services/complete/{service_id}/

Update service with full details

Updates a service entry with full details

Parameters
  • service_id (string) – The service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

True

organization_id

The identifier of the organization that provides this service.

string

True

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

True

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

True

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

contacts/0/id

Each contact must have a unique identifier.

string

True

contacts/0/organization_id

The identifier of the organization for which this is a contact.

string

False

contacts/0/service_id

The identifier of the service for which this is a contact.

string

False

contacts/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

contacts/0/name

The name of the person.

string

False

contacts/0/title

The job title of the person.

string

False

contacts/0/department

The department that the person is part of.

string

False

contacts/0/email

The email address of the person.

string

False

eligibility/0/id

Each entry must have a unique identifier.

string

True

eligibility/0/service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility/0/eligibility

The rules or guidelines that determine who can receive the service.

string

False

fees/0/id

Each entry must have a unique identifier.

string

True

fees/0/service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fees/0/fee

A listing of the costs of services, including free ones.

string

False

funding/0/id

Each entry must have a unique identifier.

string

True

funding/0/organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

funding/0/service_id

The identifier of the service for which this entry describes the source of funding.

string

False

funding/0/source

Source of funds for organization or service.

string

False

regular_schedule/0/id

Each entry must have a unique identifier.

string

True

regular_schedule/0/service_id

The identifier of the service for which this is the regular schedule.

string

False

regular_schedule/0/location_id

The identifier of the location for which this is the regular schedule.

string

False

regular_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

regular_schedule/0/weekday

The day of the week that this entry relates to.

string

True

regular_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

regular_schedule/0/closes_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/id

Each entry must have a unique identifier.

string

True

holiday_schedule/0/service_id

The identifier of the service for which this is the holiday schedule.

string

False

holiday_schedule/0/location_id

The identifier of the location for which this is the holiday schedule.

string

False

holiday_schedule/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

holiday_schedule/0/closed

Indicates if a service or location is closed during a public holiday.

boolean

True

holiday_schedule/0/opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

holiday_schedule/0/start_date

The first day that a service or location is closed during a public or private holiday.

string

True

holiday_schedule/0/end_date

The last day that a service or location is closed during a public or private holiday.

string

True

languages/0/id

Each language must have a unique identifier.

string

True

languages/0/service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

languages/0/location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

languages/0/language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

payment_accepted/0/id

Each entry must have a unique identifier.

string

True

payment_accepted/0/service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment_accepted/0/payment

The methods of payment accepted for the service.

string

False

phones/0/id

Each entry must have a unique identifier.

string

True

phones/0/location_id

The identifier of the location where this phone number is located.

string

False

phones/0/service_id

The identifier of the service for which this is the phone number.

string

False

phones/0/organization_id

The identifier of the organisation for which this is the phone number.

string

False

phones/0/contact_id

The identifier of the contact for which this is the phone number.

string

False

phones/0/service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

phones/0/number

The phone number.

string

True

phones/0/extension

The extension of the phone number.

string

False

phones/0/type

Whether the phone number relates to a fixed or cellular phone.

string

False

phones/0/department

The department for which this is the phone number.

string

False

phones/0/language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

phones/0/description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

required_documents/0/id

Each document must have a unique identifier.

string

True

required_documents/0/service_id

The identifier of the service for which this entry describes the required document.

string

False

required_documents/0/document

The document required to apply for or receive the service. e.g. Government-issued ID, EU Passport.

string

False

service_area/0/id

Each service area must have a unique identifier.

string

True

service_area/0/service_id

The identifier of the service for which this entry describes the service area.

string

False

service_area/0/service_area

The geographic area where a service is available. This is a free-text description, and so may be precise or indefinite as necessary.

string

False

service_area/0/description

A more detailed description of this service area. Used to provide any additional information that cannot be communicated using the structured area and geometry fields.

string

False

GET /services/{service_id}/

Get service

Returns a specific service entry by Id

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each organization must have a unique identifier.

string

True

name

The official or public name of the organization.

string

False

alternate_name

Alternative or commonly used name for the organization.

string

False

description

A brief summary about the organization. It can contain markup such as HTML or Markdown.

string

True

email

The contact e-mail address for the organization.

string

False

url

The URL (website address) of the organization.

string

False

tax_status

Government assigned tax designation for for tax-exempt organizations.

string

False

tax_id

A government issued identifier used for the purpose of tax administration.

string

False

year_incorporated

The year in which the organization was legally formed.

string

False

legal_status

The legal status defines the conditions that an organization is operating under; e.g. non-profit, private corporation or a government organization.

string

False

PUT /services/{service_id}/

Update service

Updates a service entry

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

DELETE /services/{service_id}/

Delete service

Deletes a service entry

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each service must have a unique identifier.

string

False

organization_id

The identifier of the organization that provides this service.

string

False

program_id

The identifier of the program this service is delivered under.

string

False

location_id

The identifier of the location where this service is delivered.

string

False

name

The official or public name of the service.

string

False

alternate_name

Alternative or commonly used name for a service.

string

False

description

A description of the service.

string

False

url

URL of the service.

string

False

email

Email address for the service.

string

False

status

The current status of the service.

string

False

interpretation_services

A description of any interpretation services available for accessing this service.

string

False

application_process

The steps needed to access the service.

string

False

wait_time

Time a client may expect to wait before receiving a service.

string

False

fees

Details of any charges for service users to access this service.

string

False

accreditations

Details of any accreditations. Accreditation is the formal evaluation of an organization or program against best practice standards set by an accrediting organization.

string

False

licenses

An organization may have a license issued by a government entity to operate legally. A list of any such licenses can be provided here.

string

False

GET /services/{service_id}/contacts/

Get all contacts for service

Returns a full list of contacts for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

POST /services/{service_id}/contacts/

Add contact for service

Creates a new contact entry for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /services/{service_id}/contacts/{contact_id}/

Get contact for service

Returns a contact entry for a specific service by Id

Parameters
  • service_id (string) – The unique service id.

  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

PUT /services/{service_id}/contacts/{contact_id}/

Update contact for service

Updates a contact entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

DELETE /services/{service_id}/contacts/{contact_id}/

Delete contact for service

Deletes a contact entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • contact_id (string) – The unique contact id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each contact must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this is a contact.

string

False

service_id

The identifier of the service for which this is a contact.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this contact is specific to a service in a particular location.

string

False

name

The name of the person.

string

False

title

The job title of the person.

string

False

department

The department that the person is part of.

string

False

email

The email address of the person.

string

False

GET /services/{service_id}/eligibility/

Get all eligibilities for service

Returns a full list of eligibilities for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility

The rules or guidelines that determine who can receive the service.

string

False

POST /services/{service_id}/eligibility/

Add eligibility for service

Creates a new eligibility entry for a service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility

The rules or guidelines that determine who can receive the service.

string

False

GET /services/{service_id}/eligibility/{eligibility_id}/

Get eligibility for service

Returns an eligibility entry for a specific service

Parameters
  • eligibility_id (string) – The unique eligibility id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility

The rules or guidelines that determine who can receive the service.

string

False

PUT /services/{service_id}/eligibility/{eligibility_id}/

Update eligibility for service

Updates an eligibility entry for a specific service

Parameters
  • eligibility_id (string) – The unique eligibility id.

  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility

The rules or guidelines that determine who can receive the service.

string

False

DELETE /services/{service_id}/eligibility/{eligibility_id}/

Delete eligibility for service

Deletes an eligibility entry for a specific service

Parameters
  • eligibility_id (string) – The unique eligibility id.

  • service_id (string) – The unique service id.

Status Codes
  • 200 OK – Eligibility Response

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the eligibility criteria.

string

False

eligibility

The rules or guidelines that determine who can receive the service.

string

False

GET /services/{service_id}/fees/

Get all fees for service

Returns a full list of fees for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fee

A listing of the costs of services, including free ones.

string

False

POST /services/{service_id}/fees/

Add fee for service

Creates a fee entry for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fee

A listing of the costs of services, including free ones.

string

False

GET /services/{service_id}/fees/{feed_id}/

Get fee for service

Returns a fee entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • feed_id (string) – The unique feed id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fee

A listing of the costs of services, including free ones.

string

False

PUT /services/{service_id}/fees/{feed_id}/

Update fee for service

Updates a fee entry for a service

Parameters
  • service_id (string) – The unique service id.

  • feed_id (string) – The unique feed id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fee

A listing of the costs of services, including free ones.

string

False

DELETE /services/{service_id}/fees/{feed_id}/

Delete fee for service

Deletes a fee entry for a service

Parameters
  • service_id (string) – The unique service id.

  • feed_id (string) – The unique feed id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this entry describes the costs of service.

string

False

fee

A listing of the costs of services, including free ones.

string

False

GET /services/{service_id}/funding/

Get all funding for service

Returns a full list of funding entries for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

POST /services/{service_id}/funding/

Add funding for service

Creates a funding entry for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

GET /services/{service_id}/funding/{funding_id}/

Get funding for service

Returns a funding entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • funding_id (string) – The unique funding id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

PUT /services/{service_id}/funding/{funding_id}/

Update funding for service

Updates a funding entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • funding_id (string) – The unique funding id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

DELETE /services/{service_id}/funding/{funding_id}/

Delete funding for service

Deletes a funding entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • funding_id (string) – The unique funding id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

organization_id

The identifier of the organization for which this entry describes the source of funding.

string

False

service_id

The identifier of the service for which this entry describes the source of funding.

string

False

source

Source of funds for organization or service.

string

False

GET /services/{service_id}/holiday-schedule/

Get all holiday schedules for service

Returns a list of holiday schedule entries for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

POST /services/{service_id}/holiday-schedule/

Add holiday schedule for service

Creates a new holiday schedule entry for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

GET /services/{service_id}/holiday-schedule/{holiday_schedule_id}/

Get holiday schedule for service

Returns a holiday schedule entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • holiday_schedule_id (string) – The unique holiday schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

PUT /services/{service_id}/holiday-schedule/{holiday_schedule_id}/

Update holiday schedule

Updates a holiday schedule entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • holiday_schedule_id (string) – The unique holiday schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

DELETE /services/{service_id}/holiday-schedule/{holiday_schedule_id}/

Delete holiday schedule for service

Deletes a holiday schedule entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • holiday_schedule_id (string) – The unique holiday schedule id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the service for which this is the holiday schedule.

string

False

location_id

The identifier of the location for which this is the holiday schedule.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this schedule is specific to a service in a particular location.

string

False

closed

Indicates if a service or location is closed during a public holiday.

boolean

True

opens_at

The time when a service or location opens. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

closes_at

The time when a service or location closes. This should use HH:MM format and should include timezone information, either adding the suffix ‘Z’ when the date is in UTC, or including an offset from UTC (e.g. 09:00-05:00 for 9am East Coast Time.

string

False

start_date

The first day that a service or location is closed during a public or private holiday.

string

True

end_date

The last day that a service or location is closed during a public or private holiday.

string

True

GET /services/{service_id}/languages/

Get languages for service

Returns a list of languages supported by a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

POST /services/{service_id}/languages/

Add languages for service

Creates new language entries for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

GET /services/{service_id}/languages/{language_id}/

Get language for service

Returns a language entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • language_id (string) – The unique language id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

PUT /services/{service_id}/languages/{language_id}/

Update language for service

Updates a language entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • language_id (string) – The unique language id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

DELETE /services/{service_id}/languages/{language_id}/

Delete language for service

Deletes a language entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • language_id (string) – The unique language id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each language must have a unique identifier.

string

True

service_id

The identifier of the service for which the entry describes the languages in which services are delivered.

string

False

location_id

The identifier of the location for which the entry describes the languages in which services are delivered.

string

False

language

Languages, other than English, in which the service is delivered. Languages are listed as ISO639-1 codes..

string

False

GET /services/{service_id}/payment-accepted/

Get all accepted paymement methods for service

Returns a list of all accepted payment methods for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment

The methods of payment accepted for the service.

string

False

POST /services/{service_id}/payment-accepted/

Add accepted payment method for service

Creates a new accepted payment method entry for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment

The methods of payment accepted for the service.

string

False

GET /services/{service_id}/payment-accepted/{payment_accepted_id}/

Get accepted payment method

Returns an accepted payment method for a specific service

Parameters
  • service_id (string) – The unique service id.

  • payment_accepted_id (string) – The unique payment accepted id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment

The methods of payment accepted for the service.

string

False

PUT /services/{service_id}/payment-accepted/{payment_accepted_id}/

Updates accepted payment method for service

Updates an accepted payment method entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • payment_accepted_id (string) – The unique payment accepted id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment

The methods of payment accepted for the service.

string

False

DELETE /services/{service_id}/payment-accepted/{payment_accepted_id}/

Delete accepted payment method for service

Deletes an accepted payment method for a specific service

Parameters
  • service_id (string) – The unique service id.

  • payment_accepted_id (string) – The unique payment accepted id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

service_id

The identifier of the services for which the entry describes the accepted payment methods.

string

False

payment

The methods of payment accepted for the service.

string

False

GET /services/{service_id}/phones/

Get all phones for service

Returns a list of phones for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

POST /services/{service_id}/phones/

Add phone for service

Creates a new phone entry for a specific service

Parameters
  • service_id (string) – The unique service id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

GET /services/{service_id}/phones/{phone_id}/

Get phone for service

Returns a phone entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False

organization_id

The identifier of the organisation for which this is the phone number.

string

False

contact_id

The identifier of the contact for which this is the phone number.

string

False

service_at_location_id

The identifier of the ‘service at location’ table entry, when this phone number is specific to a service in a particular location.

string

False

number

The phone number.

string

True

extension

The extension of the phone number.

string

False

type

Whether the phone number relates to a fixed or cellular phone.

string

False

department

The department for which this is the phone number.

string

False

language

A comma separated list of ISO 639-1, or ISO 639-2 [language codes](available at http://www.loc.gov/standards/iso639-2/php/code_list.php) to represent the languages available from this phone service. The three-letter codes from ISO 639-2 provide greater accuracy when describing variants of languages, which may be relevant to particular communities.

string

False

description

A description providing extra information about the phone service (e.g. any special arrangements for accessing, or details of availability at particular times.

string

False

PUT /services/{service_id}/phones/{phone_id}/

Update phone for service

Updates a phone entry for a specific service

Parameters
  • service_id (string) – The unique service id.

  • phone_id (string) – The unique phone id.

Status Codes

200 Response Body:

Description

Type

Required

id

Each entry must have a unique identifier.

string

True

location_id

The identifier of the location where this phone number is located.

string

False

service_id

The identifier of the service for which this is the phone number.

string

False