# Passolution Dataservice API Our API service supports following endpoints. If you need further clarification or have a feature request, feel free to contact us using our website [web.passolution.eu](https://web.passolution.eu/). Version: 2.0.0 ## Servers ``` https://api.passolution.eu/api/v2 ``` ## Security ### oAuth Type: oauth2 ### bearerAuth Authentication via Bearer Token. Use your API token in the Authorization header. Type: http Scheme: bearer Bearer Format: JWT ## Download OpenAPI description [Passolution Dataservice API](https://docs.api.passolution.eu/_bundle/api.yaml) ## API Service Get basic information about the API service like its health and version. [`GET /health`](/api/api-service/checkhealth) - Health Information [`GET /version`](/api/api-service/checkversion) - Version Information ### Health Information - [GET /health](https://docs.api.passolution.eu/api/api-service/checkhealth.md): You may ping this endpoint to confirm that Passolution API is working & accessible. ### Version Information - [GET /version](https://docs.api.passolution.eu/api/api-service/checkversion.md): Get the API version number ## Account Get an Account's subscription information & features that are available or generate a login link to log user into Passolution website automatically. [`GET /account/subscription`](/api/account/getaccountsubscription) - Info about Account's Subscription & Accessible Features [`GET /auth/login/generate_link`](/api/account/generateloginlink) - Login Link Generation ### Subscription - [GET /account/subscription](https://docs.api.passolution.eu/api/account/getaccountsubscription.md): Get information about account's subscription for Passolution service and features that are available. ### Login Link Generation - [GET /auth/login/generate_link](https://docs.api.passolution.eu/api/account/generateloginlink.md): Allows generation of a link which logs user into Passolution website directly and redirects to provided page. > {% icon name="solid circle-info" size="2em" color="var(--admonition-info-icon-color)" /%} The generated link is only valid for 30 seconds as it is supposed to be consumed immediately. Using account access token, you can generate login link of any user of the account: text .../auth/login/generate_link?page=/&username=user@example.com If you have user access token, you can generate login link for user directly: .../auth/login/generate_link?page=/ ## Basic Data You can use these endpoints to get available values for different parameter that you will need to use. [`GET /countries`](/api/basic-data/getdestinations) - Destination countries that can be queried. [`GET /nationalities`](/api/basic-data/getnationalities) - Traveller nationalities that can be queried. [`GET /languages`](/api/basic-data/getlanguages) - Entry Requirements information is available in these Languages. [`GET /tour-operators`](/api/basic-data/gettouroperators) - Additional Requirements may be available for these Tour Operators. \ \ Additionally, some endpoints support dynamic fields in requests and responses. \ The value of these dynamic fields can be known using following endpoints: [`GET /entry/documents`](/api/basic-data/getentrydocumentrecords) - Entry Requirements - Documents [`GET /entry/additional-info`](/api/basic-data/getentryadditionalinformationrecords) - Entry Requirements - Additional Info [`GET /health/immunizations`](/api/basic-data/gethealthimmunizationrecords) - Health Requirements - Immunizations ### Destinations - [GET /countries](https://docs.api.passolution.eu/api/basic-data/getdestinations.md): Get list of destinations / countries with basic information. You can use code field value of records returned in response of this endpoint as parameters to different endpoints. ### Nationalities - [GET /nationalities](https://docs.api.passolution.eu/api/basic-data/getnationalities.md): Get list of nationalities with basic information. You can use code field value of records returned in response of this endpoint as parameters to different endpoints. ### Languages - [GET /languages](https://docs.api.passolution.eu/api/basic-data/getlanguages.md): Get list of available languages. You can use code field value of records returned in response of this endpoint as parameters to different endpoints. ### Tour Operators - [GET /tour-operators](https://docs.api.passolution.eu/api/basic-data/gettouroperators.md): Get list of tour operators. You can use code field value of records returned in response of this endpoint as parameters to different endpoints to get tour operator requirements for destinations. ### Entry - Documents - [GET /entry/documents](https://docs.api.passolution.eu/api/basic-data/getentrydocumentrecords.md): Entry Document records are dynamic records that we provide information about in our Entry Requirements. \ \ You may use this endpoint to get a list of documents that are currently supported. \ The code field value of records returned in response of this endpoint, can be used as parameters to different endpoints. ### Entry - Additional Info - [GET /entry/additional-info](https://docs.api.passolution.eu/api/basic-data/getentryadditionalinformationrecords.md): Entry Additional Info records are dynamic topics that we provide information about in our Entry Requirements. \ \ You may use this endpoint to get a list of topics that are currently supported. \ The code field value of records returned in response of this endpoint, can be used as parameters to different endpoints. ### Health - Immunizations - [GET /health/immunizations](https://docs.api.passolution.eu/api/basic-data/gethealthimmunizationrecords.md): Immunization records are dynamic records that we provide information about in our Entry Requirements. \ \ You may use this endpoint to get a list of immunizations that are currently supported. \ The code field value of records returned in response of this endpoint, can be used as parameters to different endpoints. ## Entry Requirements Get Travel Requirements for destinations based on travellers' nationalities. {% icon name="solid circle-info" size="2em" color="var(--admonition-info-icon-color)" /%} HTTP GET request can be used for all endpoints if parameters can be supplied as simple query fields. \ Eg: `GET .../endpoint?destinations=ES,FR,IT&nationalities=DE,AT` ### Search Destinations - [POST /destinations](https://docs.api.passolution.eu/api/entry-requirements/searchdestinations.md): Get list of destinations / countries that meet traveller's preferences & eligibility. \ See examples below ### All Requirements - [POST /content/all/{type}](https://docs.api.passolution.eu/api/entry-requirements/getallinformation.md): Get Entry Requirements for destinations as HTML, Text or a PDF document. Use: \ .../content/all/html - to show content in a web browser / HTML viewer. \ .../content/all/text - to show content directly as text. \ .../content/all/pdf - to save & share content for offline viewing. Parameters: Simple parameters (described below) can be supplied as query parameters, eg: \ .../content/all/html?destinations=ES,FR,IT & nationalities=DE,AT & language=en ### - Overview - [POST /content/overview/{type}](https://docs.api.passolution.eu/api/entry-requirements/getoverviewinformation.md): Get Overview of Entry Requirements for destinations as HTML, JSON or a PDF document. Use: \ .../content/overview/html - to show content in a web browser / HTML viewer. \ .../content/overview/json - to show your own content based on data. \ .../content/overview/pdf - to save & share content for offline viewing. ### - Entry - [POST /content/entry/{type}](https://docs.api.passolution.eu/api/entry-requirements/getentryinformation.md): Get Entry Requirements for destinations as HTML, Text, JSON or a PDF document. Use: \ .../content/entry/html - to show content in a web browser / HTML viewer. \ .../content/entry/text - to show content directly as text. \ .../content/entry/json - to show your own content based on data. \ .../content/entry/pdf - to save & share content for offline viewing. ### - Visa - [POST /content/visa/{type}](https://docs.api.passolution.eu/api/entry-requirements/getvisainformation.md): Get Visa Requirements for destinations as HTML, Text, JSON or a PDF document. Use: \ .../content/visa/html - to show content in a web browser / HTML viewer. \ .../content/visa/text - to show content directly as text. \ .../content/visa/json - to show your own content based on data. \ .../content/visa/pdf - to save & share content for offline viewing. ### - Transit Visa - [POST /content/transit_visa/{type}](https://docs.api.passolution.eu/api/entry-requirements/gettransitvisainformation.md): Get Transit Visa Requirements for destinations as HTML, Text or a PDF document. Use: \ .../content/transit_visa/html - to show content in a web browser / HTML viewer. \ .../content/transit_visa/text - to show content directly as text. \ .../content/transit_visa/pdf - to save & share content for offline viewing. ### - Health - [POST /content/health/{type}](https://docs.api.passolution.eu/api/entry-requirements/gethealthinformation.md): Get Health Requirements for destinations as HTML, Text, JSON or a PDF document. Use: \ .../content/health/html - to show content in a web browser / HTML viewer. \ .../content/health/text - to show content directly as text. \ .../content/health/json - to show your own content based on data. \ .../content/health/pdf - to save & share content for offline viewing. ### Country Information - [POST /content/country/{type}](https://docs.api.passolution.eu/api/entry-requirements/getcountryinformation.md): Get General Information about destinations as HTML or a PDF document. Use: \ .../content/country/html - to show content in a web browser / HTML viewer. \ .../content/country/pdf - to save & share content for offline viewing. ## Travel Details Links Travel Details Link is a shareable link that you can create to share with your customers. This link allows the travellers to: - Check destination entry requirements. - Download entry requirements as PDF file for offline access. - Subscribe & receive email notifications for important changes to entry requirements. ### Create Link - [POST /travel-details/share](https://docs.api.passolution.eu/api/travel-details-links/paths/~1travel-details~1share/post.md): Creates Travel Detail Link which can be shared with travellers to allow them to check destinations' entry requirements. > {% icon name="solid circle-info" size="2em" color="var(--admonition-warning-icon-color)" /%} Requires access to customer.travel_detail_link.create feature . ### Get Links - [POST /travel-details](https://docs.api.passolution.eu/api/travel-details-links/getlinks.md): Get paginated list of Travel Details Links. > {% icon name="solid circle-info" size="2em" color="var(--admonition-warning-icon-color)" /%} Requires access to customer.travel_detail_link.manage feature . Optionally, Travel Details Links can be filtered by different fields. \ Some of the fields support advance filtering: \ reference_id, trip_name fields support like and = operators. \ start_date, end_date and created_at fields support =, > operators. Eg: Wildcard (%) search: json { "reference_id": {"like": "REF-12%"} } Eg: Exact match: json { "trip_name": {"=": "Summer Trip"} } Eg: date field operators: json { "start_date": { ">=": "2026-01-01" "<=": "2026-12-31" } } ### Get Link - [GET /travel-details/{id}](https://docs.api.passolution.eu/api/travel-details-links/gettraveldetaillink.md) ### Update Link - [POST /travel-details/{id}](https://docs.api.passolution.eu/api/travel-details-links/updatetraveldetaillink.md) ### Delete Link - [DELETE /travel-details/{id}](https://docs.api.passolution.eu/api/travel-details-links/deletetraveldetaillink.md) ### Get Media - [POST /travel-details/media](https://docs.api.passolution.eu/api/travel-details-links/gettraveldetailmedialist.md): This endpoint returns a list of Media records that are available for an account to be used as Cover Media (cover_media) for a Travel Details Link. ## Infosystem Passolution Infosystem provides access to latest news & events for destinations all around the world. We also have an endpoint that keeps you up to date with all things Passolution. ### Country News - [GET /infosystem/general](https://docs.api.passolution.eu/api/infosystem/getinfosystemgeneral.md): Get information about latest events, travel advisories and more about destinations. ### Passolution News - [GET /infosystem/passolution](https://docs.api.passolution.eu/api/infosystem/getpassolutionnews.md): Get information about latest features of our API and upcoming events at Passolution. ## Individual Content ### Individual Content - [GET /individual-content](https://docs.api.passolution.eu/api/individual-content/getindividualcontent.md) ### Update Individual Content - [POST /individual-content](https://docs.api.passolution.eu/api/individual-content/updateindividualcontent.md) ### Delete Individual Content Sections - [DELETE /individual-content](https://docs.api.passolution.eu/api/individual-content/deleteindividualcontentsections.md) ### Update Individual Content Section Order - [POST /individual-content/order](https://docs.api.passolution.eu/api/individual-content/updateindividualcontentsectionorder.md) ## Tour Operator Content ### Tour Operator Content - [GET /tour-operator/{code}](https://docs.api.passolution.eu/api/tour-operator-content/gettouroperatorcontent.md) ### Update Tour Operator Content - [POST /tour-operator/{code}](https://docs.api.passolution.eu/api/tour-operator-content/updatetouroperatorcontent.md) ### Delete Tour Operator Content Sections - [DELETE /tour-operator/{code}](https://docs.api.passolution.eu/api/tour-operator-content/deletetouroperatorcontentsections.md)