Although there’s no official REST standard, there are common approaches and best practices used across the engineering community that help define how RESTful APIs should work. For example, most RESTful APIs follow six specific constraints or design rules.

Most APIs aren’t fully RESTful, but we follow most of the practices and common definitions of the style. For example, you can take action on most resources using the standard HTTP methods: POST, GET, PATCH, and DELETE.

JSON

Some API providers will use a custom MIME type for their RESTful APIs instead of the generic JSON type (application/json). For the Sitata API, we use the generic JSON content type.

Availablity & Exponential Backoff

In rare cases, the Sitata API might be unavailble. As such, it is highly recommended to consider using a background process to retry important actions using an exponential backoff period between retries.

For example, you might design a process to create traveller or trip records in the background to your normal processing routines. In this situation, it is vital to create those records and so it is suggested that you design your architecture to be able to retry these requests.

Using a background processing architecture when interacting with important endpoints on the Sitata API is encouraged.

Company vs. End User

A few of the API endpoints are designated by the partner namespace. These endpoints are designed to give a Company access to the API for server to server communications and require authentication with the “Partner Company’s” authentication token. Most other endpoints are designed for Traveller or End User access using the Traveller record authentication token.

For example, the Company Retrieve A Trip endpoint is used by a company using the company’s authentication token to query the database and return a trip record. A traveller (end-user) can not acccess this endpoint. However, the Retrieve A Trip endpoint is used only by the traveller (end-user) to retrieve a trip record. For this endpoint, the traveller’s (end-user’s) authentication token must be used, not the company’s.

Typical Use Case

There are many ways to use and access the API depending on your partnership with Sitata. However, the typical use case is one in which a company wishes to provide Sitata’s services for its own travellers. In this case, the following procedure is recommended.

Steps one and two can be combined during the trip creation process.If step #3 sounds like a great deal of effort (and it is), you can use Sitata’s mobile SDKs to manage the large majority of these operations within your own mobile application.

Mobile SDKs

Authentication

# With shell, you can just pass the correct header with each request
curl "https://www.sitata.com/api/v1/trips"\
-H "Authorization: TKN TRAVELLER_API_KEY_HERE"

Make sure to replace TKN TRAVELLER_API_KEY_HERE with your API key.

Sitata uses API keys to allow access to the API. You can contact Sitata support to request an API key.

Sitata expects the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: TKN TRAVELLER_API_KEY_HERE

You must replace TKN TRAVELLER_API_KEY_HERE with either your company API key or the traveller API key.

This authorization header is handled automatically by the SDKs, but you will need to initalize the SDK’s with a traveller API key.

KEEP YOUR COMPANY API TOKEN A SECRET. Never place your company token on a client’s mobile device or in a public facing web service where it may be discovered. All access to Sitata services by your travellers (“end users”) should be performed using the traveller’s api token. Otherwise, you risk exposing control of your entire company pertaining to Sitata services to a third party!

Pagination

Response headers for paginated result sets will include the following:

Certain endpoints on the Sitata API will return paginated result sets to limit the amount of data in a single request. In general, an endpoint that returns a list of items or objects will return 10 items per request.

In this situation, the API will return a Link header which was introduced in RFC 5988. The link header returns a set of ready made links which you can use to determine the total number of pages and retrieve a set of objects for any given page. The API also includes a Total-Count header to indicate the total number of items in the database.

ETags

Response headers for requests will include an etag header like the following:

ETag: d64153a73b5ed6bd109a06316098dc7c

# With shell, you can just pass the correct etag header with each subsequent request to the same endpoint.
curl "https://www.sitata.com/api/v1/trips"\
-H "If-None-Match: d64153a73b5ed6bd109a06316098dc7c"

Most endpoints on the Sitata API will return an Etag in the headers of the response. ETags, short for entity tags, are a common way to conditionally verify an HTTP cache. An ETag is a digest which represents the contents of a given resource.

When a response is returned by the server it will include an ETag to represent the resource’s state as part of the HTTP response headers. Subsequent HTTP requests which want to know whether or not the resource has changed since the last request can send along the stored ETag via the If-None-Match header.

The server will then compare the current ETag for the resource to the one provided by the client. If the two ETags match, the client’s cache is considered fresh and the server can respond with a “304 Not Modified” status and an empty response body.

It is highly encouraged to use these etags with the If-None-Match header for subsequent requests on the same API endpoints.

Errors

When using the Sitata API, you might encounter the following error codes:

Error Code

Meaning

400

Bad Request – Your request was malformed.

401

Unauthorized – Your API key is wrong or expired, or you are not allowed to access the resource.

403

Forbidden – You are not allowed to access the resource requested.

404

Not Found – The specified resource could not be found

405

Method Not Allowed – You tried to access a resource with an invalid method

406

Not Acceptable – You requested a format that isn’t json

429

Too Many Requests – You’re requesting too many resources! Slow down!

500

Internal Server Error – We had a problem with our servers. Try again later.

Geographical Objects

Sitata uses TopoJSON to represent geographical boundaries and areas for display on a map. Typically, these TopoJSON objects are contained within an attribute such as topo_json. In any case, TopoJSON can be converted into GeoJson (for further processing) using the TopoJSON library by using the feature function. Sitata’s SDKs also contain libraries to convert TopoJSON into GeoJson.

Sitata does not perform an email confirmation process for traveller records that belong to a partner. Please ensure that your users have confirmed their email address and that you’re using the correct value before creating a traveller record.

This endpoint allows a partner company to remove a traveller from their records. The response body will be an empty array with a status code of 200 if successful.

Request Body Parameters

Parameter

Type

Description

traveller_id

String

The id of the traveller to remove. Specified in the url.

This action can not be undone.

Trip

Example response:

{"id":"57eb15a8fc0022814e000023","name":"My Trip","start":"2016-09-30","finish":"2016-10-03","company_name":"Go Travel Demo","employee_id":null,"employee_name":null,"muted":false,"read":false,"user_id":"57eb15a7fc0022814e000021","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T20:58:17.208-04:00","updated_at":"2016-09-27T20:58:17.208-04:00","deleted_at":null,"destinations":[{"id":"57eb15a7fc0022814e00001f","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}],"past_alert_count":0,"company_master":false,"header_image":null}

A trip belongs to a traveller and contains itinierary and health and safety information.

Attributes

Attribute

Type

Description

id

String

The id of the trip.

name

String

The name of a trip helps the traveller stay organized

start

String

The departure date of the trip. Date format is “YYYY-MM-DD”. Will be set automatically if destinations present.

finish

String

The return date of the trip. Date format is “YYYY-MM-DD”. Will be set automatically if destinations present.

company_name

String

The name of the company that created the trip. Not present in all responses.

company_id

String

The unique identifier of the company that the trip belongs to. Not present in all responses.

employee_id

String

The unique identifier of the employee that created the trip for the user. Not present in all responses.

employee_name

String

The name of the employee that created the trip for the user. Not present in all responses.

muted

Boolean

If true, the user has silenced all notifications for the trip. Not present in all responses.

read

Boolean

If true, the user has viewed the trip. Not present in all responses.

user_id

String

Unique identifier of the user that the trip belongs to. Not present in all responses.

Retrieve All Trips

[{"id":"57eb15a8fc0022814e000023","name":"My Trip","start":"2016-09-30","finish":"2016-10-03","company_name":"Go Travel Demo","employee_id":null,"employee_name":null,"muted":false,"read":false,"user_id":"57eb15a7fc0022814e000021","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T20:58:17.208-04:00","updated_at":"2016-09-27T20:58:17.208-04:00","deleted_at":null,"destinations":[{"id":"57eb15a7fc0022814e00001f","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}],"past_alert_count":0,"company_master":false,"header_image":null}]

GET https://www.sitata.com/api/v1/trips

This endpoint retrieves all trips for the traveller.

Query Parameters

Parameter

Type

Description

since

Integer

Unix time in seconds. If present, will return trips that have been modified since the given time.

Retrieve A Trip

{"id":"57eb15a8fc0022814e000023","name":"My Trip","start":"2016-09-30","finish":"2016-10-03","company_name":"Go Travel Demo","employee_id":null,"employee_name":null,"muted":false,"read":false,"user_id":"57eb15a7fc0022814e000021","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T20:58:17.208-04:00","updated_at":"2016-09-27T20:58:17.208-04:00","deleted_at":null,"destinations":[{"id":"57eb15a7fc0022814e00001f","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}],"past_alert_count":0,"company_master":false,"header_image":null}

GET https://www.sitata.com/api/v1/trips/:trip_id

This endpoint retrieves a single trip for the traveller.

Query Parameters

Parameter

Type

Description

trip_id

String

Specified in the url. The id of the trip that you wish to retreive.

Retrieve The Current Trip

{"id":"57eb15a8fc0022814e000023","name":"My Trip","start":"2016-09-30","finish":"2016-10-03","company_name":"Go Travel Demo","employee_id":null,"employee_name":null,"muted":false,"read":false,"user_id":"57eb15a7fc0022814e000021","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T20:58:17.208-04:00","updated_at":"2016-09-27T20:58:17.208-04:00","deleted_at":null,"destinations":[{"id":"57eb15a7fc0022814e00001f","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}],"past_alert_count":0,"company_master":false,"header_image":null}

GET https://www.sitata.com/api/v1/trips/current_trip

This endpoint retrieves a single trip for the traveller. This trip represents a trip which is either currently ongoing or the next upcoming trip. If there are more than one trip that satisfies these criteria, the trip with the oldest start date is returned.

{"id":"57eb15a8fc0022814e000023","name":"My Trip","start":"2016-09-30","finish":"2016-10-03","company_name":"Go Travel Demo","employee_id":null,"employee_name":null,"muted":false,"read":false,"user_id":"57eb15a7fc0022814e000021","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T20:58:17.208-04:00","updated_at":"2016-09-27T20:58:17.208-04:00","deleted_at":null,"destinations":[{"id":"57eb15a7fc0022814e00001f","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}],"past_alert_count":0,"company_master":false,"header_image":null}

The request body parameters above should be scoped within a trip key for the posted json object. Please refer to the shell/curl example.
Note that a trip’s start and finish date will be calculated and set automatically if the trip has destinations present.

{"id":"57eb15a8fc0022814e000023","name":"My Trip","start":"2016-09-30","finish":"2016-10-03","company_name":"Go Travel Demo","employee_id":null,"employee_name":null,"muted":false,"read":false,"user_id":"57eb15a7fc0022814e000021","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T20:58:17.208-04:00","updated_at":"2016-09-27T20:58:17.208-04:00","deleted_at":null,"destinations":[{"id":"57eb15a7fc0022814e00001f","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}],"past_alert_count":0,"company_master":false,"header_image":null}

PUT https://www.sitata.com/api/v1/trips/:trip_id

This endpoint allows a traveller to update a trip for themselves. The request paramaters and validations are the same as for creating a trip.

If destinations are specified while updating a trip, the new destinations specified will overwrite and replace the prior destinations.
Note that a trip’s start and finish date will be calculated and set automatically if the trip has destinations present.

Company Retrieve All Trips

[{"id":"57eabef0fc0022ae69000040","start":"2016-09-30","finish":"2016-10-03","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T14:48:16.926-04:00","updated_at":"2016-09-27T14:48:16.926-04:00","destinations":[{"id":"57eabef0fc0022ae69000059","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"There is a significant risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination_id":"5261f58733012653cbe9ee2d","vaccination_name":"Hepatitis A Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"Japanese encephalitis usually occurs in rural farming areas in China. Outbreaks have been recorded in all provinces except Xizang (Tibet), Xinjiang, and Qinghai. The risk for travellers of contracting Japanese encephalitis is low, but visiting areas where the virus is active and extensive outdoor activity in rural areas will increase this risk.","disease_id":"4f831e85fe75bd2c230004c7","disease_name":"Japanese encephalitis","country_id":"4f831e85fe75bd2c230004fe"}],"travellers":[{"id":"57eabef0fc0022ae6900003f","created_at":"2016-09-27T14:48:16.993-04:00","updated_at":"2016-09-27T14:48:16.993-04:00","first_name":"Jim","last_name":"Robbins","email":"jimrobbins-email@gmail.com","home_country":"CA","language":"en","authentication_token":"eyJ0eXAiOiJKV1QiLsx4bGciOiJIUzI2NiJ9.eyJpYXQiOjE0NzUwMDIwOTcsu8N1YiI7IjU3ZWFiZWYxZmMwMDIyYWU2OTAwMDA1YiIsInR5cCI6IlVzZXIifQ.5vMi7ARpo21IrO-1I8jWQ1GsMGf9ziWHPk_Tg-6fZU"}]}]

GET https://www.sitata.com/api/v1/partner/trips

This endpoint retrieves all trips for the partner company using Sitata. Results are paginated.

Query Parameters

Parameter

Type

Description

since

Integer

Unix time in seconds. If present, will return trips that have been modified since the given time.

page

Integer

The current page number.

Company Retrieve A Trip

{"id":"57eabef0fc0022ae69000040","start":"2016-09-30","finish":"2016-10-03","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T14:48:16.926-04:00","updated_at":"2016-09-27T14:48:16.926-04:00","destinations":[{"id":"57eabef0fc0022ae69000059","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"There is a significant risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination_id":"5261f58733012653cbe9ee2d","vaccination_name":"Hepatitis A Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"Japanese encephalitis usually occurs in rural farming areas in China. Outbreaks have been recorded in all provinces except Xizang (Tibet), Xinjiang, and Qinghai. The risk for travellers of contracting Japanese encephalitis is low, but visiting areas where the virus is active and extensive outdoor activity in rural areas will increase this risk.","disease_id":"4f831e85fe75bd2c230004c7","disease_name":"Japanese encephalitis","country_id":"4f831e85fe75bd2c230004fe"}],"travellers":[{"id":"57eabef0fc0022ae6900003f","created_at":"2016-09-27T14:48:16.993-04:00","updated_at":"2016-09-27T14:48:16.993-04:00","first_name":"Jim","last_name":"Robbins","email":"jimrobbins-email@gmail.com","home_country":"CA","language":"en","authentication_token":"eyJ0eXAiOiJKV1QiLsx4bGciOiJIUzI2NiJ9.eyJpYXQiOjE0NzUwMDIwOTcsu8N1YiI7IjU3ZWFiZWYxZmMwMDIyYWU2OTAwMDA1YiIsInR5cCI6IlVzZXIifQ.5vMi7ARpo21IrO-1I8jWQ1GsMGf9ziWHPk_Tg-6fZU"}]}

GET https://www.sitata.com/api/v1/partner/trips/:trip_id

This endpoint retrieves a single trip for the partner company using Sitata.

{"id":"57eabef0fc0022ae69000040","start":"2016-09-30","finish":"2016-10-03","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T14:48:16.926-04:00","updated_at":"2016-09-27T14:48:16.926-04:00","destinations":[{"id":"57eabef0fc0022ae69000059","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"There is a significant risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination_id":"5261f58733012653cbe9ee2d","vaccination_name":"Hepatitis A Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"Japanese encephalitis usually occurs in rural farming areas in China. Outbreaks have been recorded in all provinces except Xizang (Tibet), Xinjiang, and Qinghai. The risk for travellers of contracting Japanese encephalitis is low, but visiting areas where the virus is active and extensive outdoor activity in rural areas will increase this risk.","disease_id":"4f831e85fe75bd2c230004c7","disease_name":"Japanese encephalitis","country_id":"4f831e85fe75bd2c230004fe"}],"travellers":[{"id":"57eabef0fc0022ae6900003f","created_at":"2016-09-27T14:48:16.993-04:00","updated_at":"2016-09-27T14:48:16.993-04:00","first_name":"Jim","last_name":"Robbins","email":"jimrobbins-email@gmail.com","home_country":"CA","language":"en","authentication_token":"eyJ0eXAiOiJKV1QiLsx4bGciOiJIUzI2NiJ9.eyJpYXQiOjE0NzUwMDIwOTcsu8N1YiI7IjU3ZWFiZWYxZmMwMDIyYWU2OTAwMDA1YiIsInR5cCI6IlVzZXIifQ.5vMi7ARpo21IrO-1I8jWQ1GsMGf9ziWHPk_Tg-6fZU"}]}

POST https://www.sitata.com/api/v1/partner/trips/

This endpoint allows a partner company to create a trip for a set of travellers. The trip parameters should be nested inside a trip parameter key. Travellers can be created at the same time as the trip by specifying the traveller attributes using the travellers key in the request body. Alternatively, existing travellers can be speicifed using the traveller_ids key in the request body.

A trip which has a valid start and finish date, but no destinations is known as an “empty trip.” An empty trip is useful because it can notify mobile clients to prompt the trip building process which can collect more details directly from the user.
If you create a trip for a pre-existing traveller using their email address, this endpoint will automatically use the existing traveller without throwing any errors.
Please refer to the Trip Start and Finish Date section for information on how these properties are set.

{"id":"57eabef0fc0022ae69000040","start":"2016-09-30","finish":"2016-10-03","company_id":"55db6dceb157fd5756000001","trip_type":0,"activities":[0],"created_at":"2016-09-27T14:48:16.926-04:00","updated_at":"2016-09-27T14:48:16.926-04:00","destinations":[{"id":"57eabef0fc0022ae69000059","departure_date":"2016-09-30","return_date":"2016-10-03","country_id":"4f831e85fe75bd2c230004fe","country_code":"CN","destination_locations":[{"friendly_name":"Hong Kong","latitude":22.3964,"longitude":114.1095}]}],"trip_medication_comments":[{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}],"trip_vaccination_comments":[{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities. ","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"There is a significant risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination_id":"5261f58733012653cbe9ee2d","vaccination_name":"Hepatitis A Vaccine","country_id":"4f831e85fe75bd2c230004fe"}],"trip_disease_comments":[{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"},{"comment":"Japanese encephalitis usually occurs in rural farming areas in China. Outbreaks have been recorded in all provinces except Xizang (Tibet), Xinjiang, and Qinghai. The risk for travellers of contracting Japanese encephalitis is low, but visiting areas where the virus is active and extensive outdoor activity in rural areas will increase this risk.","disease_id":"4f831e85fe75bd2c230004c7","disease_name":"Japanese encephalitis","country_id":"4f831e85fe75bd2c230004fe"}],"travellers":[{"id":"57eabef0fc0022ae6900003f","created_at":"2016-09-27T14:48:16.993-04:00","updated_at":"2016-09-27T14:48:16.993-04:00","first_name":"Jim","last_name":"Robbins","email":"jimrobbins-email@gmail.com","home_country":"CA","language":"en","authentication_token":"eyJ0eXAiOiJKV1QiLsx4bGciOiJIUzI2NiJ9.eyJpYXQiOjE0NzUwMDIwOTcsu8N1YiI7IjU3ZWFiZWYxZmMwMDIyYWU2OTAwMDA1YiIsInR5cCI6IlVzZXIifQ.5vMi7ARpo21IrO-1I8jWQ1GsMGf9ziWHPk_Tg-6fZU"}]}

PUT https://www.sitata.com/api/v1/partner/trips/:trip_id

This endpoint allows a company to update one of their trip records. The request paramaters and validations are the same as for creating a trip with the exception that you can not adjust the travellers associated with the trip.

If destinations are specified while updating a trip, the new destinations specified will overwrite and replace the prior destinations.
Please refer to the Trip Start and Finish Date section for information on how these properties are set.

An array of traveller object attributes. See below. Must not be used in conjunction with traveller_ids

traveller_ids

[String]

An array of traveller ids to associate to this trip. Must not be used in conjunction with travellers.

Trip Start and Finish Date

// After the trip's properties have been updated based on the given parameters, then
// the following pseudo code applies when Sitata determines whether or not to set
// the `start` and `finish` date from the trip's destination list.
if calc_trip_dates is present
return calc_trip_dates
else if start is present OR finish is present
return false
else if trip contains destinations
return true
else
return false
end

The following logic applies when Sitata determines what the start and finish date of a trip should be.

If you specify the calc_trip_dates boolean parameter, then the desired behavior is forced regardless of the other conditions outlined below. For example, if set to false then the trip’s start and finish date will be set to the values you provide. If set to true, then the trip’s start and finish date will be calculated based on the trip’s destination list.

If there are no destinations provided, Sitata will not calculate trip dates. If creating a trip, you are expected to provide them in this scenario.

If you give Sitata a startor a finish date, then Sitata does not calculate the dates from the destination list.

When the start date is not provided and the finish date is not provided, but destinations are provided, then Sitata will remove the entire prior list of destinations and will re-calculate the start and finish date based on the new destination list given.

This endpoint allows a partner company to remove a trip from their records. The response body will be an empty array with a status code of 200 if successful.

Request Body Parameters

Parameter

Type

Description

trip_id

String

The id of the trip to remove. Specified in the url.

This action can not be undone.

Trip Disease Comment

Example json:

{"comment":"In China, cities and popular tourist areas, including Yangtze River cruises, are not at risk and do not require anti-malarial medication. Rural areas only in the following provinces are at risk: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Malaria does not occur in urban areas.","disease_id":"4f831e85fe75bd2c230004cc","disease_name":"Malaria","country_id":"4f831e85fe75bd2c230004fe"}

A Trip Disease Comment provides a country specific explanation about why a Disease is present for a particular country. This resource is never accessed directly and is only ever accessed or changed when dealing with a Trip.

Trip Medication Comment

{"comment":"Anti-malarial medication is recommended for travellers going to the following rural provinces: Hainan, Henan, Yunnan, Guizhou, Anhui, Hubei, and Jiangsu. Anti-malaria drug resistance for chloroquine and mefloquine is present. Recommended medication depends on the provinces visited: For Yunnan, atovaquone-proguanil or doxycycline. For Hainan, atovaquone-proguanil, doxycycline, or mefloquine. For Anhui, Guizhou, Henan, and Hubei, atovaquone-proguanil, chloroquine, doxycycline, mefloquine or primaquine.","medication_id":"5261f58633012653cbe9ee1f","medication_name":"Anti-malarial Drugs","country_id":"4f831e85fe75bd2c230004fe"}

A Trip Medication Comment provides a country specific explanation about why a Medication is recommended for a particular country. This resource is never accessed directly and is only ever accessed or changed when dealing with a Trip.

Trip Vaccination Comment

Example json:

{"comment":"This vaccination is recommended for people who plan extensive outdoor activities while visiting rural or farming areas during the months of May to October. It is not recommended for itineraries that are limited to Beijing or other major cities.","vaccination_id":"5261f58733012653cbe9ee33","vaccination_name":"Japanese Encephalitis Vaccine","country_id":"4f831e85fe75bd2c230004fe"}

A Trip Vaccination Comment provides a country specific explanation about why a Vaccination is recommended for a particular country. This resource is never accessed directly and is only ever accessed or changed when dealing with a Trip.

Destination Location

A destination can have locations associated with it. This resource is never accessed directly and only ever accessed or changed when dealing with a Trip. These entries are used during Sitata’s Trip Alert process.

Attributes

Attribute

Type

Description

friendly_name

String

A name for the location for display purposes.

latitude

Double

The latitude of the location.

longitude

Double

The longitude of the location.

Country

Example json:

{"id":"4f831e85fe75bd2c230004eb","slug":"argentina","created_at":"2012-04-09T13:38:13.000-04:00","updated_at":"2015-10-24T12:12:05.808-04:00","deleted_at":null,"name":"Argentina","country_code":"AR","country_code_3":"ARG","facts":"Argentina is the second largest country in South America, with a...","capital":"Buenos Aires","language":"Spanish. Languages also spoken are English, Italian, German, and French.","currency_name":"Argentine peso","currency_code":"ARS","division_name":"province","region_name":"municipality","travel_status":0,"sec_emer_num":"\r\n\r\n","sec_personal":"Travellers to Argentina should exercise a high degree...","sec_ext_viol":"","sec_pol_unr":"- Demonstrations, strikes, and roadblocks can occur at any time...","sec_areas":"- Travellers should exercise caution near Iguazú Falls and areas...","flag":{"url":"system/countries/AR/flag/AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg","main":"system/countries/AR/flag/main_AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg","list":"system/countries/AR/flag/list_AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg"},"country_datum":{"id":"51322cbc28bfd4464800002b","company_id":"51322b3e28bfd4c7dd000001","country_disease_comments":[{"comment":"There is a risk for hepatitis A virus exposure in Argentina.","disease":{"id":"4f831e85fe75bd2c230004c4","common_name":"Hepatitis A"}},{"comment":"There is a low risk of infection with hepatitis B for this country.","disease":{"id":"4f831e85fe75bd2c230004c5","common_name":"Hepatitis B"}},{"comment":"Unvaccinated people can become infected through contaminated food and water in this country, especially when visiting smaller cities, villages or rural areas where food and water sources may be contaminated.","disease":{"id":"4f831e85fe75bd2c230004e3","common_name":"Typhoid Fever"}}],"country_medication_comments":[{"comment":"Although the risk of malaria is low, travellers may consider anti-malaria medication if travelling in rural areas of northern Salta Province (along the Bolivian border), Chaco and Misiones Provinces (along the Paraguay border). Recommended anti-malaria medication includes atovaquone-proguanil, chloroquine, doxycycline and mefloquine.","medication":{"id":"5261f58633012653cbe9ee1f","name":"Anti-malarial Drugs"}}],"country_vaccination_comments":[{"comment":"There is a risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination":{"id":"5261f58733012653cbe9ee2d","name":"Hepatitis A Vaccine"}},{"comment":"Yellow fever vaccination is recommended for northern and northeastern forested areas of Argentina bordering Brazil and Paraguay where altitudes are less than 2300 meters. Travellers to departments in the following provinces should be vaccinated: Misiones (all departments) and Corrientes (Berón de Astrada, Capital, General Alvear, General Paz, Ituzaingó, Itatí, Paso de los Libres, San Cosme, San Martín, San Miguel, Santo Tomé). Vaccination is also recommended for travellers visiting Iguazu Falls. \r\n\r\nYellow fever vaccination is not recommended for the provinces of Formosa, Chaco, Jujuy, and Salta. ","vaccination":{"id":"5261f58733012653cbe9ee45","name":"Yellow Fever Vaccine"}}]},"emerg_numbers":[{"typ":90,"val":"911","note":"In Buenos Aires and surrounding province of Buenos Aires","order":0},{"typ":90,"val":"101","note":"","order":1},{"typ":91,"val":"100","note":"","order":2},{"typ":92,"val":"107","note":"","order":3},{"typ":90,"val":"112","note":"Mobile phones - Directs to local emergency number","order":4}]}

A Country object represents a real-world country and contains various health and safety information for the region. A Country object also maintains geographical information used to highlight regions to the end user.

Attributes

Attribute

Type

Description

id

String

The id of the country.

slug

String

An alternative string which can be used to query the database.

created_at

String

The date the country was created. A JSON string representing a datetime using ISO 8601 format

updated_at

String

The date the country was last updated. A JSON string representing a datetime using ISO 8601 format

deleted_at

String

The date the country was removed. A JSON string representing a datetime using ISO 8601 format. Not present in all responses.

The flag object simply represents various assets available which represent the country’s national flag.

Key

Description

url

The original flag asset.

main

A large version of the flag asset. Maximum 80px wide and 80px tall.

list

A smaller version of the flag asset meant for use in list views. Maximum 20px wide and 20px tall.

Country Datum

The country datum is used to contain country health information such as vaccinations, medications, and diseases within it. The reason it is contained as a separate object as the “datum” serves as a layer to allow certain partners of Sitata to customize the health information to their own preferences. This allows, for example, a company in Belgium to choose to serve Belgian health recommendations to their users, while another company might simply wish to use the default health recommendations of Sitata.

Retrieve All Countries

[{"id":"4f831e85fe75bd2c230004eb","slug":"argentina","created_at":"2012-04-09T13:38:13.000-04:00","updated_at":"2015-10-24T12:12:05.808-04:00","deleted_at":null,"name":"Argentina","country_code":"AR","country_code_3":"ARG","facts":"Argentina is the second largest country in South America, with a...","capital":"Buenos Aires","language":"Spanish. Languages also spoken are English, Italian, German, and French.","currency_name":"Argentine peso","currency_code":"ARS","division_name":"province","region_name":"municipality","travel_status":0,"sec_emer_num":"\r\n\r\n","sec_personal":"Travellers to Argentina should exercise a high degree...","sec_ext_viol":"","sec_pol_unr":"- Demonstrations, strikes, and roadblocks can occur at any time...","sec_areas":"- Travellers should exercise caution near Iguazú Falls and areas...","flag":{"url":"system/countries/AR/flag/AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg","main":"system/countries/AR/flag/main_AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg","list":"system/countries/AR/flag/list_AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg"},"country_datum":{"id":"51322cbc28bfd4464800002b","company_id":"51322b3e28bfd4c7dd000001","country_disease_comments":[{"comment":"There is a risk for hepatitis A virus exposure in Argentina.","disease":{"id":"4f831e85fe75bd2c230004c4","common_name":"Hepatitis A"}},{"comment":"There is a low risk of infection with hepatitis B for this country.","disease":{"id":"4f831e85fe75bd2c230004c5","common_name":"Hepatitis B"}},{"comment":"Unvaccinated people can become infected through contaminated food and water in this country, especially when visiting smaller cities, villages or rural areas where food and water sources may be contaminated.","disease":{"id":"4f831e85fe75bd2c230004e3","common_name":"Typhoid Fever"}}],"country_medication_comments":[{"comment":"Although the risk of malaria is low, travellers may consider anti-malaria medication if travelling in rural areas of northern Salta Province (along the Bolivian border), Chaco and Misiones Provinces (along the Paraguay border). Recommended anti-malaria medication includes atovaquone-proguanil, chloroquine, doxycycline and mefloquine.","medication":{"id":"5261f58633012653cbe9ee1f","name":"Anti-malarial Drugs"}}],"country_vaccination_comments":[{"comment":"There is a risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination":{"id":"5261f58733012653cbe9ee2d","name":"Hepatitis A Vaccine"}},{"comment":"Yellow fever vaccination is recommended for northern and northeastern forested areas of Argentina bordering Brazil and Paraguay where altitudes are less than 2300 meters. Travellers to departments in the following provinces should be vaccinated: Misiones (all departments) and Corrientes (Berón de Astrada, Capital, General Alvear, General Paz, Ituzaingó, Itatí, Paso de los Libres, San Cosme, San Martín, San Miguel, Santo Tomé). Vaccination is also recommended for travellers visiting Iguazu Falls. \r\n\r\nYellow fever vaccination is not recommended for the provinces of Formosa, Chaco, Jujuy, and Salta. ","vaccination":{"id":"5261f58733012653cbe9ee45","name":"Yellow Fever Vaccine"}}]},"emerg_numbers":[{"typ":90,"val":"911","note":"In Buenos Aires and surrounding province of Buenos Aires","order":0},{"typ":90,"val":"101","note":"","order":1},{"typ":91,"val":"100","note":"","order":2},{"typ":92,"val":"107","note":"","order":3},{"typ":90,"val":"112","note":"Mobile phones - Directs to local emergency number","order":4}]}]

GET https://www.sitata.com/api/v1/countries

This endpoint retrieves all countries.

Query Parameters

Parameter

Type

Description

since

Integer

Unix time in seconds. If present, will return countries that have been modified since the given time.

This endpoint is effective for pre-loading a list of countries with the bare minimum amount of data to make a country selection or build a trip. Health and extra data for each country is ommitted. The endpoint retrieves all countries with only the following attributes: id, slug, created_at, updated_at, name, country_code, travel_status, sec_emer_num, flag, emerg_numbers.

Query Parameters

Parameter

Type

Description

since

Integer

Unix time in seconds. If present, will return countries that have been modified since the given time.

Retrieve A Country

{"id":"4f831e85fe75bd2c230004eb","slug":"argentina","created_at":"2012-04-09T13:38:13.000-04:00","updated_at":"2015-10-24T12:12:05.808-04:00","deleted_at":null,"name":"Argentina","country_code":"AR","country_code_3":"ARG","facts":"Argentina is the second largest country in South America, with a...","capital":"Buenos Aires","language":"Spanish. Languages also spoken are English, Italian, German, and French.","currency_name":"Argentine peso","currency_code":"ARS","division_name":"province","region_name":"municipality","travel_status":0,"sec_emer_num":"\r\n\r\n","sec_personal":"Travellers to Argentina should exercise a high degree...","sec_ext_viol":"","sec_pol_unr":"- Demonstrations, strikes, and roadblocks can occur at any time...","sec_areas":"- Travellers should exercise caution near Iguazú Falls and areas...","flag":{"url":"system/countries/AR/flag/AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg","main":"system/countries/AR/flag/main_AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg","list":"system/countries/AR/flag/list_AR-9592fb89-50f2-4b70-a8d8-39450a71ec4c.jpg"},"country_datum":{"id":"51322cbc28bfd4464800002b","company_id":"51322b3e28bfd4c7dd000001","country_disease_comments":[{"comment":"There is a risk for hepatitis A virus exposure in Argentina.","disease":{"id":"4f831e85fe75bd2c230004c4","common_name":"Hepatitis A"}},{"comment":"There is a low risk of infection with hepatitis B for this country.","disease":{"id":"4f831e85fe75bd2c230004c5","common_name":"Hepatitis B"}},{"comment":"Unvaccinated people can become infected through contaminated food and water in this country, especially when visiting smaller cities, villages or rural areas where food and water sources may be contaminated.","disease":{"id":"4f831e85fe75bd2c230004e3","common_name":"Typhoid Fever"}}],"country_medication_comments":[{"comment":"Although the risk of malaria is low, travellers may consider anti-malaria medication if travelling in rural areas of northern Salta Province (along the Bolivian border), Chaco and Misiones Provinces (along the Paraguay border). Recommended anti-malaria medication includes atovaquone-proguanil, chloroquine, doxycycline and mefloquine.","medication":{"id":"5261f58633012653cbe9ee1f","name":"Anti-malarial Drugs"}}],"country_vaccination_comments":[{"comment":"There is a risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination":{"id":"5261f58733012653cbe9ee2d","name":"Hepatitis A Vaccine"}},{"comment":"Yellow fever vaccination is recommended for northern and northeastern forested areas of Argentina bordering Brazil and Paraguay where altitudes are less than 2300 meters. Travellers to departments in the following provinces should be vaccinated: Misiones (all departments) and Corrientes (Berón de Astrada, Capital, General Alvear, General Paz, Ituzaingó, Itatí, Paso de los Libres, San Cosme, San Martín, San Miguel, Santo Tomé). Vaccination is also recommended for travellers visiting Iguazu Falls. \r\n\r\nYellow fever vaccination is not recommended for the provinces of Formosa, Chaco, Jujuy, and Salta. ","vaccination":{"id":"5261f58733012653cbe9ee45","name":"Yellow Fever Vaccine"}}]},"emerg_numbers":[{"typ":90,"val":"911","note":"In Buenos Aires and surrounding province of Buenos Aires","order":0},{"typ":90,"val":"101","note":"","order":1},{"typ":91,"val":"100","note":"","order":2},{"typ":92,"val":"107","note":"","order":3},{"typ":90,"val":"112","note":"Mobile phones - Directs to local emergency number","order":4}]}

Geographical regions for the country, its divisions (provinces/states) and its regions (municipalities) are provided when necessary. This data is provided in order of increasing importance as determined by the Travel Status of each area.

For example, if a country as a whole has a Travel Status of 0, and a province has a Travel Status of 0, then the country’s geographical border will be provided, but not the province. If a country as a whole has a Travel Status of 0, and a province has a Travel Status of 1, then the country’s geographical border will be provided and the provincial border will also be provided because it maintains a larger travel status. This order of operations also applies to the country’s regions.

Attribute

Type

Description

id

String

The id of the country.

slug

String

An alternative string which can be used to query the database.

created_at

String

The date the country was created. A JSON string representing a datetime using ISO 8601 format

updated_at

String

The date the country was last updated. A JSON string representing a datetime using ISO 8601 format

A country’s geographical border is guaranteed to be returned, but not necessarily any data for the division or region objects.
Instead of the country identifier, you may also use the country’s ISO 3166-1 alpha 2 country code.

Country Disease Comment

Example json:

{"comment":"There is a significant risk for hepatitis A virus exposure in Afghanistan through contaminated food or water. ","disease":{"id":"4f831e85fe75bd2c230004c4","common_name":"Hepatitis A"}}

The Country Disease Comment object contains information about why a traveller should be aware of a Disease for a particular country.

Attributes

Country Medication Comment

Example json:

{"comment":"Recommended anti-malaria medications include atovaquone-proguanil, mefloquine or doxycycline. Resistance to chloroquine has been reported.Recommended anti-malaria medications include atovaquone-proguanil, mefloquine or doxycycline. Resistance to chloroquine has been reported.","medication":{"id":"5261f58633012653cbe9ee1f","name":"Anti-malarial Drugs"}}

The Country Medication Comment object contains information about why a traveller should consider a Medication for a country.

Attributes

Country Vaccination Comment

Example json:

{"comment":"There is a significant risk of exposure to hepatitis A for this country, therefore, the vaccination is recommended.","vaccination":{"id":"5261f58733012653cbe9ee2d","name":"Hepatitis A Vaccine"}}

The Country Vaccination Comment object contains information about why a traveller should consider a Vaccination for a country.

Disease

Example json:

{"id":"4f831e85fe75bd2c230004e4","updated_at":"2013-11-09T11:02:24.985-05:00","created_at":"2012-04-09T13:38:13.000-04:00","deleted_at":null,"slug":"chicken-pox","common_name":"Chicken Pox","name":"Chicken Pox","full_name":"Chicken Pox (Varicella-zoster)","scientific_name":"Varicella-zoster","occurs_where":"Chicken pox occurs worldwide. Some countries have vaccination programs against varicella that have decreased the risk of exposure. These countries include the United States, Australia, Canada, Costa Rica, Dominican Republic, Germany, Mexico, Qatar, Spain, South Korea, Switzerland, United Arab Emirates, and Uruguay.","disease_datum":{"id":"51322d4b28bfd43d580000e3","description":"Varicella-zoster, also commonly known as chicken pox, is a highly contagious skin disease caused by the varicella-zoster virus, a member of the herpes virus family. Infection with this virus is often considered as a \"nuisance\" and uncomfortable disease of childhood. \n\nPeople of all ages can contract varicella; however, the disease occurs more often in children, with most people contracting varicella by the age of 15. The disease is usually more severe in adults.\n","transmission":"Varicella is highly contagious. It is transmitted person to person through respiratory droplets coughed into the air by an infected patient. The virus enters through the upper-respiratory tract or the conjunctiva (eyes). Varicella virus can also be transmitted through contact with fluid from the characteristic open sores that form on the skin. It can also be transmitted indirectly through contact with the belongings of an infected person or any item that has been exposed to fluid draining from blisters and open sores. Once an infected person's sores have crusted over, they are generally no longer contagious. ","susceptibility":"Most people acquire lifetime immunity to varicella after they have recovered from a first infection. In otherwise healthy persons, clinical illness after reexposure is rare. The virus can sometimes reappear later in life in the form of a disease called shingles (also known as herpes zoster, or simply zoster).\n","symptoms":"Varicella is usually a mild disease in children, lasting 4 to 7 days. The period of contagiousness of infected persons is estimated to begin 1 to 2 days before the onset of rash and to end when all the sores are crusted, typically 4 to 7 days after onset of rash. Symptoms of varicella include: mild fever up to 102 ?F; weakness; and an itchy rash which generally begins on the scalp, then includes the trunk, and finally the arms and legs. The varicella rash develops in crops with red bumps that progress to blisters which then burst and create open sores before scabbing over. Complications of varicella can include: bacterial skin infection which can cause scarring, particularly when the patient continually scratches their sores; cerebellar ataxia (loss of coordination of muscle movements); encephalitis (inflammation of the brain); nerve palsies (damaged nerves); Reye?s syndrome (a severe combination of liver and brain disease that is associated with taking aspirin).\n\nOther serious complications can occur in patients with AIDS, lupus, leukemia, and cancer, or in those taking immune-suppressing drugs. Newborn infants whose mothers contract varicella in the last trimester of pregnancy can be affected by the disease. If the mother develops varicella from five days before delivery to two days after, the baby?s fatality rate increases significantly.\n\nBreakthrough varicella is a modified version of the disease that can occur in some vaccinated persons, as the vaccine is only 70 - 90 percent effective in preventing the disease. Breakthrough varicella usually presents with a milder rash, less fever, and shorter duration. Mild, breakthrough varicella is still infectious, and persons suspected of having the disease should be isolated. \n\nAfter the initial infection is over, the virus still remains dormant in sensory nerves where it might be reactivated at a later time, causing a different illness called herpes zoster or shingles. This is a very painful rash that typically appears n the skin of the chest or abdomen along the distribution of the sensory nerves under the skin. \n","prevention":"There is a good vaccine to prevent varicella virus infection. People suspected of having varicella should avoid contact with others to prevent spread of the infection.\n\nMany industrialised countries aim to eliminate varicella by including the chickenpox vaccine as part of their national immunisation schedules. All children should have the chickenpox vaccine, unless they have a compromised immune system. \n","treatment":"Treatment for varicella is mainly to relieve symptoms. Acetaminophen is used to decrease fever and aches in the initial stages of the disease. Aspirin should never be given to children due to the risk of developing Reye?s syndrome. The severe itching from the rash can be decreased with oatmeal baths and over-the-counter lotions and moisturisers, such as calamine lotion. Itching can also be controlled with Benadryl or other antihistamines. Minimizing scratching will help to diminish the risk of bacterial infection associated with varicella.\n\nAcyclovir, an antiviral medication, is sometimes prescribed to patients with pre-existing medical conditions that put them at risk for severe disease (such as those with severe skin diseases or immunodeficiency). \n","medications":[{"id":"5261f58633012653cbe9ee23","slug":"anti-viral-medication","name":"Anti-viral medication"}],"vaccinations":[{"id":"5261f58733012653cbe9ee43","slug":"varicella-chicken-pox-vaccine","name":"Varicella (Chicken Pox) Vaccine"}]}}

The Disease object contains information about a particular disease that a traveller should know about.

Attributes

Attribute

Type

Description

id

String

The id of the trip.

slug

String

An alternative string which can be used to query the database.

created_at

String

The date the country was created. A JSON string representing a datetime using ISO 8601 format

updated_at

String

The date the country was last updated. A JSON string representing a datetime using ISO 8601 format

deleted_at

String

The date the country was removed. A JSON string representing a datetime using ISO 8601 format. Not present in all responses.

Disease Datum

The disease datum is used to contain additional disease health information about the disease. The reason it is contained as a separate object as the “datum” serves as a layer to allow certain partners of Sitata to customize the health information to their own preferences. This allows, for example, a company in Belgium to choose to serve Belgian health information about the disease to their users, while another company might simply wish to use the default health information provided by Sitata.

Retrieve All Diseases

[{"id":"4f831e85fe75bd2c230004e4","updated_at":"2013-11-09T11:02:24.985-05:00","created_at":"2012-04-09T13:38:13.000-04:00","deleted_at":null,"slug":"chicken-pox","common_name":"Chicken Pox","name":"Chicken Pox","full_name":"Chicken Pox (Varicella-zoster)","scientific_name":"Varicella-zoster","occurs_where":"Chicken pox occurs worldwide. Some countries have vaccination programs against varicella that have decreased the risk of exposure. These countries include the United States, Australia, Canada, Costa Rica, Dominican Republic, Germany, Mexico, Qatar, Spain, South Korea, Switzerland, United Arab Emirates, and Uruguay.","disease_datum":{"id":"51322d4b28bfd43d580000e3","description":"Varicella-zoster, also commonly known as chicken pox, is a highly contagious skin disease caused by the varicella-zoster virus, a member of the herpes virus family. Infection with this virus is often considered as a \"nuisance\" and uncomfortable disease of childhood. \n\nPeople of all ages can contract varicella; however, the disease occurs more often in children, with most people contracting varicella by the age of 15. The disease is usually more severe in adults.\n","transmission":"Varicella is highly contagious. It is transmitted person to person through respiratory droplets coughed into the air by an infected patient. The virus enters through the upper-respiratory tract or the conjunctiva (eyes). Varicella virus can also be transmitted through contact with fluid from the characteristic open sores that form on the skin. It can also be transmitted indirectly through contact with the belongings of an infected person or any item that has been exposed to fluid draining from blisters and open sores. Once an infected person's sores have crusted over, they are generally no longer contagious. ","susceptibility":"Most people acquire lifetime immunity to varicella after they have recovered from a first infection. In otherwise healthy persons, clinical illness after reexposure is rare. The virus can sometimes reappear later in life in the form of a disease called shingles (also known as herpes zoster, or simply zoster).\n","symptoms":"Varicella is usually a mild disease in children, lasting 4 to 7 days. The period of contagiousness of infected persons is estimated to begin 1 to 2 days before the onset of rash and to end when all the sores are crusted, typically 4 to 7 days after onset of rash. Symptoms of varicella include: mild fever up to 102 ?F; weakness; and an itchy rash which generally begins on the scalp, then includes the trunk, and finally the arms and legs. The varicella rash develops in crops with red bumps that progress to blisters which then burst and create open sores before scabbing over. Complications of varicella can include: bacterial skin infection which can cause scarring, particularly when the patient continually scratches their sores; cerebellar ataxia (loss of coordination of muscle movements); encephalitis (inflammation of the brain); nerve palsies (damaged nerves); Reye?s syndrome (a severe combination of liver and brain disease that is associated with taking aspirin).\n\nOther serious complications can occur in patients with AIDS, lupus, leukemia, and cancer, or in those taking immune-suppressing drugs. Newborn infants whose mothers contract varicella in the last trimester of pregnancy can be affected by the disease. If the mother develops varicella from five days before delivery to two days after, the baby?s fatality rate increases significantly.\n\nBreakthrough varicella is a modified version of the disease that can occur in some vaccinated persons, as the vaccine is only 70 - 90 percent effective in preventing the disease. Breakthrough varicella usually presents with a milder rash, less fever, and shorter duration. Mild, breakthrough varicella is still infectious, and persons suspected of having the disease should be isolated. \n\nAfter the initial infection is over, the virus still remains dormant in sensory nerves where it might be reactivated at a later time, causing a different illness called herpes zoster or shingles. This is a very painful rash that typically appears n the skin of the chest or abdomen along the distribution of the sensory nerves under the skin. \n","prevention":"There is a good vaccine to prevent varicella virus infection. People suspected of having varicella should avoid contact with others to prevent spread of the infection.\n\nMany industrialised countries aim to eliminate varicella by including the chickenpox vaccine as part of their national immunisation schedules. All children should have the chickenpox vaccine, unless they have a compromised immune system. \n","treatment":"Treatment for varicella is mainly to relieve symptoms. Acetaminophen is used to decrease fever and aches in the initial stages of the disease. Aspirin should never be given to children due to the risk of developing Reye?s syndrome. The severe itching from the rash can be decreased with oatmeal baths and over-the-counter lotions and moisturisers, such as calamine lotion. Itching can also be controlled with Benadryl or other antihistamines. Minimizing scratching will help to diminish the risk of bacterial infection associated with varicella.\n\nAcyclovir, an antiviral medication, is sometimes prescribed to patients with pre-existing medical conditions that put them at risk for severe disease (such as those with severe skin diseases or immunodeficiency). \n","medications":[{"id":"5261f58633012653cbe9ee23","slug":"anti-viral-medication","name":"Anti-viral medication"}],"vaccinations":[{"id":"5261f58733012653cbe9ee43","slug":"varicella-chicken-pox-vaccine","name":"Varicella (Chicken Pox) Vaccine"}]}}]

GET https://www.sitata.com/api/v1/diseases

This endpoint retrieves all diseases.

Query Parameters

Parameter

Type

Description

since

Integer

Unix time in seconds. If present, will return diseases that have been modified since the given time.

Retrieve A Disease

{"id":"4f831e85fe75bd2c230004e4","updated_at":"2013-11-09T11:02:24.985-05:00","created_at":"2012-04-09T13:38:13.000-04:00","deleted_at":null,"slug":"chicken-pox","common_name":"Chicken Pox","name":"Chicken Pox","full_name":"Chicken Pox (Varicella-zoster)","scientific_name":"Varicella-zoster","occurs_where":"Chicken pox occurs worldwide. Some countries have vaccination programs against varicella that have decreased the risk of exposure. These countries include the United States, Australia, Canada, Costa Rica, Dominican Republic, Germany, Mexico, Qatar, Spain, South Korea, Switzerland, United Arab Emirates, and Uruguay.","disease_datum":{"id":"51322d4b28bfd43d580000e3","description":"Varicella-zoster, also commonly known as chicken pox, is a highly contagious skin disease caused by the varicella-zoster virus, a member of the herpes virus family. Infection with this virus is often considered as a \"nuisance\" and uncomfortable disease of childhood. \n\nPeople of all ages can contract varicella; however, the disease occurs more often in children, with most people contracting varicella by the age of 15. The disease is usually more severe in adults.\n","transmission":"Varicella is highly contagious. It is transmitted person to person through respiratory droplets coughed into the air by an infected patient. The virus enters through the upper-respiratory tract or the conjunctiva (eyes). Varicella virus can also be transmitted through contact with fluid from the characteristic open sores that form on the skin. It can also be transmitted indirectly through contact with the belongings of an infected person or any item that has been exposed to fluid draining from blisters and open sores. Once an infected person's sores have crusted over, they are generally no longer contagious. ","susceptibility":"Most people acquire lifetime immunity to varicella after they have recovered from a first infection. In otherwise healthy persons, clinical illness after reexposure is rare. The virus can sometimes reappear later in life in the form of a disease called shingles (also known as herpes zoster, or simply zoster).\n","symptoms":"Varicella is usually a mild disease in children, lasting 4 to 7 days. The period of contagiousness of infected persons is estimated to begin 1 to 2 days before the onset of rash and to end when all the sores are crusted, typically 4 to 7 days after onset of rash. Symptoms of varicella include: mild fever up to 102 ?F; weakness; and an itchy rash which generally begins on the scalp, then includes the trunk, and finally the arms and legs. The varicella rash develops in crops with red bumps that progress to blisters which then burst and create open sores before scabbing over. Complications of varicella can include: bacterial skin infection which can cause scarring, particularly when the patient continually scratches their sores; cerebellar ataxia (loss of coordination of muscle movements); encephalitis (inflammation of the brain); nerve palsies (damaged nerves); Reye?s syndrome (a severe combination of liver and brain disease that is associated with taking aspirin).\n\nOther serious complications can occur in patients with AIDS, lupus, leukemia, and cancer, or in those taking immune-suppressing drugs. Newborn infants whose mothers contract varicella in the last trimester of pregnancy can be affected by the disease. If the mother develops varicella from five days before delivery to two days after, the baby?s fatality rate increases significantly.\n\nBreakthrough varicella is a modified version of the disease that can occur in some vaccinated persons, as the vaccine is only 70 - 90 percent effective in preventing the disease. Breakthrough varicella usually presents with a milder rash, less fever, and shorter duration. Mild, breakthrough varicella is still infectious, and persons suspected of having the disease should be isolated. \n\nAfter the initial infection is over, the virus still remains dormant in sensory nerves where it might be reactivated at a later time, causing a different illness called herpes zoster or shingles. This is a very painful rash that typically appears n the skin of the chest or abdomen along the distribution of the sensory nerves under the skin. \n","prevention":"There is a good vaccine to prevent varicella virus infection. People suspected of having varicella should avoid contact with others to prevent spread of the infection.\n\nMany industrialised countries aim to eliminate varicella by including the chickenpox vaccine as part of their national immunisation schedules. All children should have the chickenpox vaccine, unless they have a compromised immune system. \n","treatment":"Treatment for varicella is mainly to relieve symptoms. Acetaminophen is used to decrease fever and aches in the initial stages of the disease. Aspirin should never be given to children due to the risk of developing Reye?s syndrome. The severe itching from the rash can be decreased with oatmeal baths and over-the-counter lotions and moisturisers, such as calamine lotion. Itching can also be controlled with Benadryl or other antihistamines. Minimizing scratching will help to diminish the risk of bacterial infection associated with varicella.\n\nAcyclovir, an antiviral medication, is sometimes prescribed to patients with pre-existing medical conditions that put them at risk for severe disease (such as those with severe skin diseases or immunodeficiency). \n","medications":[{"id":"5261f58633012653cbe9ee23","slug":"anti-viral-medication","name":"Anti-viral medication"}],"vaccinations":[{"id":"5261f58733012653cbe9ee43","slug":"varicella-chicken-pox-vaccine","name":"Varicella (Chicken Pox) Vaccine"}]}}

GET https://www.sitata.com/api/v1/diseases/:disease_id

This endpoint retrieves a disease.

Vaccination

Example json:

{"id":"5261f58733012653cbe9ee27","slug":"bacillus-calmette-guerin-bcg-vaccine","name":"Bacillus Calmette-Guérin (BCG) Vaccine","updated_at":"2013-11-23T12:41:14.769-05:00","vaccination_datum":{"id":"5261f58733012653cbe9ee28","description":"BCG is a vaccine made specifically for tuberculous. It has only marginal effectiveness for preventing tuberculosis.\n\nMany countries do not use this vaccine because of its limited effectiveness in control programs when TB is uncommon in the population.\n\nIn countries where TB is common and relatively uncontrolled, the BCG vaccine is part of their TB control programs. Infants are targeted for vaccination since this vaccine does have some protective effect for children who are frequently exposed.","routine":false,"schedule":"One injection","side_effects":"Side effects from BCG vaccine are extraordinarily rare. \n\n\nBCG vaccine should not be given to persons who are immune suppressed, e.g., with HIV, organ transplant recipients, or pregnant women."}}

The Vaccination object contains information about a particular vaccination that a traveller should know about.

Attributes

Attribute

Type

Description

id

String

The id of the trip.

slug

String

An alternative string which can be used to query the database.

created_at

String

The date the country was created. A JSON string representing a datetime using ISO 8601 format

updated_at

String

The date the country was last updated. A JSON string representing a datetime using ISO 8601 format

Vaccination Datum

The vaccination datum is used to contain additional disease health information about the vaccination. The reason it is contained as a separate object as the “datum” serves as a layer to allow certain partners of Sitata to customize the health information to their own preferences. This allows, for example, a company in Belgium to choose to serve Belgian health information about the vaccination to their users, while another company might simply wish to use the default health information provided by Sitata.

Retrieve All Vaccinations

[{"id":"5261f58733012653cbe9ee27","slug":"bacillus-calmette-guerin-bcg-vaccine","name":"Bacillus Calmette-Guérin (BCG) Vaccine","updated_at":"2013-11-23T12:41:14.769-05:00","vaccination_datum":{"id":"5261f58733012653cbe9ee28","description":"BCG is a vaccine made specifically for tuberculous. It has only marginal effectiveness for preventing tuberculosis.\n\nMany countries do not use this vaccine because of its limited effectiveness in control programs when TB is uncommon in the population.\n\nIn countries where TB is common and relatively uncontrolled, the BCG vaccine is part of their TB control programs. Infants are targeted for vaccination since this vaccine does have some protective effect for children who are frequently exposed.","routine":false,"schedule":"One injection","side_effects":"Side effects from BCG vaccine are extraordinarily rare. \n\n\nBCG vaccine should not be given to persons who are immune suppressed, e.g., with HIV, organ transplant recipients, or pregnant women."}}]

GET https://www.sitata.com/api/v1/vaccinations

This endpoint retrieves all vaccinations.

Retrieve A Vaccination

{"id":"5261f58733012653cbe9ee27","slug":"bacillus-calmette-guerin-bcg-vaccine","name":"Bacillus Calmette-Guérin (BCG) Vaccine","updated_at":"2013-11-23T12:41:14.769-05:00","vaccination_datum":{"id":"5261f58733012653cbe9ee28","description":"BCG is a vaccine made specifically for tuberculous. It has only marginal effectiveness for preventing tuberculosis.\n\nMany countries do not use this vaccine because of its limited effectiveness in control programs when TB is uncommon in the population.\n\nIn countries where TB is common and relatively uncontrolled, the BCG vaccine is part of their TB control programs. Infants are targeted for vaccination since this vaccine does have some protective effect for children who are frequently exposed.","routine":false,"schedule":"One injection","side_effects":"Side effects from BCG vaccine are extraordinarily rare. \n\n\nBCG vaccine should not be given to persons who are immune suppressed, e.g., with HIV, organ transplant recipients, or pregnant women."}}

GET https://www.sitata.com/api/v1/vaccinations/:vaccination_id

This endpoint retrieves a vaccination.

Medication

Example json:

{"id":"5261f58633012653cbe9ee21","slug":"anti-parasite-drugs","updated_at":"2013-11-23T12:34:51.404-05:00","name":"Anti-parasite drugs","medication_datum":{"id":"5261f58633012653cbe9ee22","description":"Many drugs are used to treat parasitic infections ( Thiabendazole, Pyrantel pamoate, Mebendazole, Praziquantel, Niclosamide, Bithionol, Oxamniquine, Metrifonate, Ivermectin, Albendazole, Benznidazole, Nifurtimox, Nitroimidazole). Some of these drugs may not be available in all countries. Treatment of malaria parasites require a separate, special group of anti-malaria drugs not listed here. Some of these drugs have significant toxicity and should be taken only under the direct care of physicians who specialize in the treatment of parasitic diseases","routine":false,"schedule":"","side_effects":""}}

The Medication object contains information about a particular medication that a traveller should know about.

Attributes

Attribute

Type

Description

id

String

The id of the trip.

slug

String

An alternative string which can be used to query the database.

created_at

String

The date the country was created. A JSON string representing a datetime using ISO 8601 format

updated_at

String

The date the country was last updated. A JSON string representing a datetime using ISO 8601 format

Medication Datum

The medication datum is used to contain additional disease health information about the medication. The reason it is contained as a separate object as the “datum” serves as a layer to allow certain partners of Sitata to customize the health information to their own preferences. This allows, for example, a company in Belgium to choose to serve Belgian health information about the medication to their users, while another company might simply wish to use the default health information provided by Sitata.

Retrieve All Medications

[{"id":"5261f58633012653cbe9ee21","slug":"anti-parasite-drugs","updated_at":"2013-11-23T12:34:51.404-05:00","name":"Anti-parasite drugs","medication_datum":{"id":"5261f58633012653cbe9ee22","description":"Many drugs are used to treat parasitic infections ( Thiabendazole, Pyrantel pamoate, Mebendazole, Praziquantel, Niclosamide, Bithionol, Oxamniquine, Metrifonate, Ivermectin, Albendazole, Benznidazole, Nifurtimox, Nitroimidazole). Some of these drugs may not be available in all countries. Treatment of malaria parasites require a separate, special group of anti-malaria drugs not listed here. Some of these drugs have significant toxicity and should be taken only under the direct care of physicians who specialize in the treatment of parasitic diseases","routine":false,"schedule":"","side_effects":""}}]

GET https://www.sitata.com/api/v1/medications

This endpoint retrieves all medications.

Retrieve A Medication

{"id":"5261f58633012653cbe9ee21","slug":"anti-parasite-drugs","updated_at":"2013-11-23T12:34:51.404-05:00","name":"Anti-parasite drugs","medication_datum":{"id":"5261f58633012653cbe9ee22","description":"Many drugs are used to treat parasitic infections ( Thiabendazole, Pyrantel pamoate, Mebendazole, Praziquantel, Niclosamide, Bithionol, Oxamniquine, Metrifonate, Ivermectin, Albendazole, Benznidazole, Nifurtimox, Nitroimidazole). Some of these drugs may not be available in all countries. Treatment of malaria parasites require a separate, special group of anti-malaria drugs not listed here. Some of these drugs have significant toxicity and should be taken only under the direct care of physicians who specialize in the treatment of parasitic diseases","routine":false,"schedule":"","side_effects":""}}

GET https://www.sitata.com/api/v1/medications/:medication_id

This endpoint retrieves a medication.

Alert

Example json:

{"id":"58b5a11ab157fd539100170c","slug":"pakistan-reports-first-cases-of-chikungunya-fever","headline":"Pakistan reports first cases of chikungunya fever","body":"Since mid-December last year, a total of 803 cases have been reported in Sindh province, including 29 cases reported in Karachi in the second week in February. ","body_advice":"While the risk of exposure for travellers may vary from place to place, it may be high in some localities.\n\nAll travellers to areas where chikungunya fever virus is active can reduce their risk of exposure to this virus by taking all necessary precautions to avoid mosquito bites. Many persons with chikungunya fever do not seek medical care and are not reported to health authorities. This may account for the low numbers of reported cases in many countries. There may be many more cases in the community that are not reported. Chikungunya virus infections may have long lasting health consequences.","category":"health","risk_level":"medium","incubation":false,"country_ids":["4f831e86fe75bd2c2300052a"],"safety_ids":[],"disease_ids":["4f831e85fe75bd2c230004b7"],"full_country_ids":[],"alert_sources":[{"_id":"58b5a11cb157fd539100170d","host":"outbreaknewstoday.com","url":"http://outbreaknewstoday.com/chikungunya-hundreds-cases-reported-pakistan-27154/"}],"created_at":"2017-02-28","updated_at":"2017-02-28","start":"2012-04-09T13:38:13.000-04:00","finish":"2012-04-10T13:38:13.000-04:00","origin_alert_id":null,"alert_locations":[{"id":"58b5a11cb157fd539100170e","location":[67.00993879999999,24.8614622]}],"countries":[{"id":"546031e25e0fc9772fccadd2","name":"Pakistan","travel_status":1,"topo_json":"<TOPOJSON OBJECT OR NULL>"}],"country_divisions":[{"id":"546031e25e0fc9772fccadd2","name":"Sind","country_id":"4f831e86fe75bd2c2300052a","travel_status":1,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}

An Alert or “Trip Alert” contains information about a situation which may disrupt a traveller’s trip. The Alert object can contain geographical data for the requested country. Refer to Geographical Objects for more information.

Attributes

Attribute

Type

Description

id

String

The id of the alert.

created_at

String

The date the alert was created. A JSON string representing a datetime using the format YYYY-mm-dd.

updated_at

String

The date the alert was last updated. A JSON string representing a datetime using the format YYYY-mm-dd.

start

String

The time at which the alert will become effective. A JSON string representing a datetime using ISO 8601 format

finish

String

The time at which the alert is no longer applicable. A JSON string representing a datetime using ISO 8601 format

Alert Location

An Alert Location represents a singular location (map pin) for the event.

Attribute

Type

Description

id

String

The id of the alert location.

location

[LNG, LAT]

An array representing the coordinates of the event. Coordinates are given as [longitude, latitude].

Alert Countries

The array of alert countries provides additional information about the country associated with the alert. It’s data structure is not the full Country data structure. Further, its topo_json property is only present if the country is listed in the full_country_ids array.

Retrieve Alerts For A Trip

{"trip_alerts":[{"id":"4fda8cec28bfd40473000001","incubation":false,"read":null,"alert_id":"4fda8ceb28bfd43c10000002","trip_id":"4fda891928bfd43c06000004","alert":{"id":"4fda8ceb28bfd43c10000002","slug":"hand-foot-and-mouth-disease-explosive-epidemic-in-don-nai-province-vietnam","headline":"Hand, foot & mouth disease - explosive epidemic in Don Nai Province, Vietnam","body":"An explosive, rapidly expanding epidemic of hand...","body_advice":null,"category":"health","risk_level":"low","incubation":false,"country_ids":["4f831e86fe75bd2c2300054f"],"safety_ids":[],"disease_ids":["4f831e85fe75bd2c230004c2"],"alert_sources":[{"_id":"4fda8ceb28bfd43c10000003","host":"news.xinhuanet.com","url":"http://news.xinhuanet.com/english/health/2012-06/14/c_131652550.htm"}],"created_at":"2013-09-14","updated_at":"2013-09-14","alert_locations":[{"id":"4fda8d0728bfd43c0b000006","location":[107.19572029999995,11.1097639]}],"country_divisions":[],"country_regions":[],"country_division_ids":[],"country_region_ids":[]}}],"past_alerts":[{"id":"58a6f7e4b157fde5d8000e8a","slug":"terrorist-attacks-in-pakistan","headline":"Terrorist attacks in Pakistan ","body":"At least 88 people were killed and hundreds injured in a suicide attack Thursday at Pakistan's Lal Shahbaz Qalandar shrine in the southern town of Sehwan in Sindh province. This attack is the latest of a string of attacks in Pakistan this week. Monday, a bomb exploded during a protest in Lahore outside the Punjab assembly. Two police officers were killed on Tuesday while attempting to defuse a bomb in Quetta. Wednesday, there was a bombing at a government office in the Mohmand tribal area, and also a suicide attack on government employees in Peshawar.","body_advice":"Security has been increased. Two border crossing with Afghanistan have been closed, Chaman and Torkham.\n\nTerrorist attacks are frequent in Pakistan. There is a high threat from terrorism, kidnapping and sectarian violence throughout Pakistan. In the interest of minimizing safety risk, limit your frequency of travel and minimize the time spent in and around markets, restaurants, religious sites, government installations, and other public locations. If possible avoid using public transportation in Pakistan. Only use hotels that have rigorous security procedures. Avoid all public gatherings and events, protests and rallies. Even peaceful situations can quickly and unexpectedly become violent.\n","category":"safety","risk_level":"high","incubation":false,"country_ids":["4f831e86fe75bd2c2300052a"],"safety_ids":["558e0bceb157fd26a90001e4"],"disease_ids":[],"alert_sources":[{"_id":"58a6f7e7b157fde5d8000e8b","host":"rss.cnn.com","url":"http://rss.cnn.com/~r/rss/cnn_world/~3/tNyAz-DLsYM/index.html"},{"_id":"58a6f7e7b157fde5d8000e8c","host":"www.albawaba.com","url":"http://www.albawaba.com/news/death-toll-pakistan-sufi-shrine-bombing-rises-70-250-injured-939012"},{"_id":"58a6f7e7b157fde5d8000e8d","host":"www.aljazeera.com","url":"http://www.aljazeera.com/news/2017/02/pakistan-launches-crackdown-sehwan-blast-170217053807857.html"},{"_id":"58a6f7e7b157fde5d8000e8e","host":"www.aljazeera.com","url":"http://www.aljazeera.com/news/2017/02/blast-hits-pakistan-lal-shahbaz-qalandar-sufi-shrine-170216144747128.html"}],"created_at":"2017-02-17","updated_at":"2017-02-17","alert_locations":[{"id":"58a6f7e7b157fde5d8000e8f","location":[67.86239120000005,26.4289349]},{"id":"58a6f7e7b157fde5d8000e90","location":[74.32603310000002,31.5614672]},{"id":"58a6f7e7b157fde5d8000e91","location":[71.58048989999998,34.0149748]},{"id":"58a6f7e7b157fde5d8000e92","location":[66.99873400000001,30.1829713]},{"id":"58a6f7e7b157fde5d8000e93","location":[66.43840309999996,30.954647]},{"id":"58a6f7e7b157fde5d8000e94","location":[71.09376320000001,34.1223575]}],"country_divisions":[],"country_regions":[],"country_division_ids":[],"country_region_ids":[]}]}

In the future, this endpoint’s response format will be changed to a simple array of alert objects sorted by date and it will be up to the client to differentiate between alerts that were issued during the trip or prior to the trip start. A separate endpoint will be created for trip_alert metadata details.

Retrieve An Alert

{"id":"58b5a11ab157fd539100170c","slug":"pakistan-reports-first-cases-of-chikungunya-fever","headline":"Pakistan reports first cases of chikungunya fever","body":"Since mid-December last year, a total of 803 cases have been reported in Sindh province, including 29 cases reported in Karachi in the second week in February. ","body_advice":"While the risk of exposure for travellers may vary from place to place, it may be high in some localities.\n\nAll travellers to areas where chikungunya fever virus is active can reduce their risk of exposure to this virus by taking all necessary precautions to avoid mosquito bites. Many persons with chikungunya fever do not seek medical care and are not reported to health authorities. This may account for the low numbers of reported cases in many countries. There may be many more cases in the community that are not reported. Chikungunya virus infections may have long lasting health consequences.","category":"health","risk_level":"medium","incubation":false,"country_ids":["4f831e86fe75bd2c2300052a"],"safety_ids":[],"disease_ids":["4f831e85fe75bd2c230004b7"],"full_country_ids":[],"alert_sources":[{"_id":"58b5a11cb157fd539100170d","host":"outbreaknewstoday.com","url":"http://outbreaknewstoday.com/chikungunya-hundreds-cases-reported-pakistan-27154/"}],"created_at":"2017-02-28","updated_at":"2017-02-28","start":"2012-04-09T13:38:13.000-04:00","finish":"2012-04-10T13:38:13.000-04:00","origin_alert_id":null,"alert_locations":[{"id":"58b5a11cb157fd539100170e","location":[67.00993879999999,24.8614622]}],"countries":[{"id":"546031e25e0fc9772fccadd2","name":"Pakistan","travel_status":1,"topo_json":"<TOPOJSON OBJECT OR NULL>"}],"country_divisions":[{"id":"546031e25e0fc9772fccadd2","name":"Sind","country_id":"4f831e86fe75bd2c2300052a","travel_status":1,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}

GET https://www.sitata.com/api/v1/alerts/:alert_id

This endpoint retrieves an alert.

Retrieve A Country’s Alerts

[{"id":"58b5a11ab157fd539100170c","slug":"pakistan-reports-first-cases-of-chikungunya-fever","headline":"Pakistan reports first cases of chikungunya fever","body":"Since mid-December last year, a total of 803 cases have been reported in Sindh province, including 29 cases reported in Karachi in the second week in February. ","body_advice":"While the risk of exposure for travellers may vary from place to place, it may be high in some localities.\n\nAll travellers to areas where chikungunya fever virus is active can reduce their risk of exposure to this virus by taking all necessary precautions to avoid mosquito bites. Many persons with chikungunya fever do not seek medical care and are not reported to health authorities. This may account for the low numbers of reported cases in many countries. There may be many more cases in the community that are not reported. Chikungunya virus infections may have long lasting health consequences.","category":"health","risk_level":"medium","incubation":false,"country_ids":["4f831e86fe75bd2c2300052a"],"safety_ids":[],"disease_ids":["4f831e85fe75bd2c230004b7"],"full_country_ids":[],"alert_sources":[{"_id":"58b5a11cb157fd539100170d","host":"outbreaknewstoday.com","url":"http://outbreaknewstoday.com/chikungunya-hundreds-cases-reported-pakistan-27154/"}],"created_at":"2017-02-28","updated_at":"2017-02-28","start":"2012-04-09T13:38:13.000-04:00","finish":"2012-04-10T13:38:13.000-04:00","origin_alert_id":null,"alert_locations":[{"id":"58b5a11cb157fd539100170e","location":[67.00993879999999,24.8614622]}],"countries":[{"id":"546031e25e0fc9772fccadd2","name":"Pakistan","travel_status":1,"topo_json":"<TOPOJSON OBJECT OR NULL>"}],"country_divisions":[{"id":"546031e25e0fc9772fccadd2","name":"Sind","country_id":"4f831e86fe75bd2c2300052a","travel_status":1,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}]

Advisory

Example json:

{"id":"5148d53028bfd43b4d00000d","slug":"violence-and-kidnappings","headline":"Violence and Kidnappings","body":"Recent attacks in Pakistan have focused on Pakistani governmental targets, particularly security and military institutions. In addition, places of worship and religious sites have also been targets. A Western diplomatic vehicle was attacked in a suicide bombing in Peshawar on September 3, 2012. \n \n \nPolitical and sectarian violence is on-going in Karachi. In 2012, hundreds of people were killed as a result of this violence. \n \n \nIn the Federally Administered Tribal Areas (FATA), and Khyber-Pakhtunkhwa, fighting has occurred between government forces and militants. Lawlessness is a serious concern in these areas. The security situation in Swat and South Waziristan is volatile. The military operations in these areas have caused a number of civilian casualties and deaths. Bombings, shootings, and mass demonstrations occur regularly. \n \n \nAcross Pakistan, there is a high threat of kidnapping, but especially in Baluchistan, the FATA, and Khyber-Pakhtunkhwa. Kidnappings have occurred in Lahore and Multanin Punjab and Naushahro Feroz in Sindh. A humanitarian worker was kidnapped in Quetta and later murdered in April, 2012. \n","status":0,"country_id":"4f831e86fe75bd2c2300052a","created_at":"2013-03-19","updated_at":"2013-03-19","country_divisions":[{"id":"546031e25e0fc9772fccadcb","name":"Azad Kashmir","country_id":"4f831e86fe75bd2c2300052a","travel_status":2,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}

An Adviory contains information about a long-standing situation which may disrupt a traveller’s trip. The main difference between an advisory and an alert is simply that an advisory is an ongoing issue that can last for a much longer period of time. The Advisory object can contain geographical data for the requested country. Refer to Geographical Objects for more information.

Attributes

Attribute

Type

Description

id

String

The id of the advisory.

created_at

String

The date the advisory was created. A JSON string representing a datetime using the format YYYY-mm-dd.

updated_at

String

The date the advisory was last updated. A JSON string representing a datetime using the format YYYY-mm-dd.

Retrieve Advisories For A Trip

[{"id":"5148d53028bfd43b4d00000d","slug":"violence-and-kidnappings","headline":"Violence and Kidnappings","body":"Recent attacks in Pakistan have focused on Pakistani governmental targets, particularly security and military institutions. In addition, places of worship and religious sites have also been targets. A Western diplomatic vehicle was attacked in a suicide bombing in Peshawar on September 3, 2012. \n \n \nPolitical and sectarian violence is on-going in Karachi. In 2012, hundreds of people were killed as a result of this violence. \n \n \nIn the Federally Administered Tribal Areas (FATA), and Khyber-Pakhtunkhwa, fighting has occurred between government forces and militants. Lawlessness is a serious concern in these areas. The security situation in Swat and South Waziristan is volatile. The military operations in these areas have caused a number of civilian casualties and deaths. Bombings, shootings, and mass demonstrations occur regularly. \n \n \nAcross Pakistan, there is a high threat of kidnapping, but especially in Baluchistan, the FATA, and Khyber-Pakhtunkhwa. Kidnappings have occurred in Lahore and Multanin Punjab and Naushahro Feroz in Sindh. A humanitarian worker was kidnapped in Quetta and later murdered in April, 2012. \n","status":0,"country_id":"4f831e86fe75bd2c2300052a","created_at":"2013-03-19","updated_at":"2013-03-19","country_divisions":[{"id":"546031e25e0fc9772fccadcb","name":"Azad Kashmir","country_id":"4f831e86fe75bd2c2300052a","travel_status":2,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}]

GET https://www.sitata.com/api/v1/trips/:trip_id/advisories

This endpoint retrieves advisories for a trip.

Retrieve An Advisory

{"id":"5148d53028bfd43b4d00000d","slug":"violence-and-kidnappings","headline":"Violence and Kidnappings","body":"Recent attacks in Pakistan have focused on Pakistani governmental targets, particularly security and military institutions. In addition, places of worship and religious sites have also been targets. A Western diplomatic vehicle was attacked in a suicide bombing in Peshawar on September 3, 2012. \n \n \nPolitical and sectarian violence is on-going in Karachi. In 2012, hundreds of people were killed as a result of this violence. \n \n \nIn the Federally Administered Tribal Areas (FATA), and Khyber-Pakhtunkhwa, fighting has occurred between government forces and militants. Lawlessness is a serious concern in these areas. The security situation in Swat and South Waziristan is volatile. The military operations in these areas have caused a number of civilian casualties and deaths. Bombings, shootings, and mass demonstrations occur regularly. \n \n \nAcross Pakistan, there is a high threat of kidnapping, but especially in Baluchistan, the FATA, and Khyber-Pakhtunkhwa. Kidnappings have occurred in Lahore and Multanin Punjab and Naushahro Feroz in Sindh. A humanitarian worker was kidnapped in Quetta and later murdered in April, 2012. \n","status":0,"country_id":"4f831e86fe75bd2c2300052a","created_at":"2013-03-19","updated_at":"2013-03-19","country_divisions":[{"id":"546031e25e0fc9772fccadcb","name":"Azad Kashmir","country_id":"4f831e86fe75bd2c2300052a","travel_status":2,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}

GET https://www.sitata.com/api/v1/advisories/:advisory_id

This endpoint retrieves an advisory.

Retrieve A Country’s Advisories

[{"id":"5148d53028bfd43b4d00000d","slug":"violence-and-kidnappings","headline":"Violence and Kidnappings","body":"Recent attacks in Pakistan have focused on Pakistani governmental targets, particularly security and military institutions. In addition, places of worship and religious sites have also been targets. A Western diplomatic vehicle was attacked in a suicide bombing in Peshawar on September 3, 2012. \n \n \nPolitical and sectarian violence is on-going in Karachi. In 2012, hundreds of people were killed as a result of this violence. \n \n \nIn the Federally Administered Tribal Areas (FATA), and Khyber-Pakhtunkhwa, fighting has occurred between government forces and militants. Lawlessness is a serious concern in these areas. The security situation in Swat and South Waziristan is volatile. The military operations in these areas have caused a number of civilian casualties and deaths. Bombings, shootings, and mass demonstrations occur regularly. \n \n \nAcross Pakistan, there is a high threat of kidnapping, but especially in Baluchistan, the FATA, and Khyber-Pakhtunkhwa. Kidnappings have occurred in Lahore and Multanin Punjab and Naushahro Feroz in Sindh. A humanitarian worker was kidnapped in Quetta and later murdered in April, 2012. \n","status":0,"country_id":"4f831e86fe75bd2c2300052a","created_at":"2013-03-19","updated_at":"2013-03-19","country_divisions":[{"id":"546031e25e0fc9772fccadcb","name":"Azad Kashmir","country_id":"4f831e86fe75bd2c2300052a","travel_status":2,"topo_json":"<TOPOJSON OBJECT>"}],"country_regions":[]}]

This endpoint is used by the traveller to update settings on their account. They can not update other information such as their email. In order to update their other properties, refer to Company Update A Traveller.

This endpoint is used to store mobile device details such as the push notification token associated with the device. This is necessary so that Sitata can send push notifications to the device. The post parameters should be nested inside a device parameter key.

POST Parameters

Parameter

Type

Description

uuid

String

The unique identifier for the device.

token

String

The push notification token for the device.

locale

String

The ISO 639-1 two character language code that the user has set on their device. e.g. “en”