Deprecated
Endpoints deprecated in v2
Create temporary profile
Deprecated. Use /profiles/*. Creates a new temporary customer profile. Temporary profiles are used when consents are given by an anonymous user, or where we need to add just a name to a hardcopy pdf ticket when the buyer doesn't have a full profile. In those cases, we still require a customer reference in the consents API, so a customer profile must exist. However, the profile does not need to be permanent. Specifically, temporary profiles have an expiration date. On that date, they will be deleted from the system. Also, several fields that are required for a permanent profile, are voluntary for a temporary profile. A mechanism exists for converting a temporary profile into a permanent one.
Headers
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Create temporary profile › Request Body
createdByWho created the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
expirationDateThe date when the customers personal data should be deleted. Personal data will be deleted continuously. ISO 8601 date format
createdByChannelWhich sales channel or system who created the customer. Used for traceability in accordance with GDPR
emailContact email
surnameSurname.
firstNameFirst and middle name.
countryCodeTelephone number country code, starting with +.
dateOfBirthDate of birth. ISO 8601 date format
landlineNumberLandline telephone number.
organisationIdThe organisation the customer is registered with.
telephoneNumberDeprecated. Please use countryCode and telephoneNumberNoCountryCode. Telephone number for customer. This should be a cell phone number.
telephoneNumberNoCountryCodeTelephone number without country code or punctuation.
customerAccountIdDeprecated. Use /profiles/{customerNumber}/customer-accounts. Customer account id used for account based ticketing
Create temporary profile › Responses
OK
uuidA universal unique id for the customer. 32 random alphanumeric characters. Not RFC 4122 compliant
statusCustomer status. Statuses supported: 'A' = Active, 'P' = Passive, 'D' = Deleted. Default is 'A'.
surnameSurname.
changedAtWhen the customer was last changed. ISO 8601 date format
changedByWho last changed the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
createdAtWhen the customer was created. ISO 8601 date format
createdByWho created the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
firstNameFirst and middle name.
customerNumberCustomer number.
expirationDateThe date when the customers personal data should be deleted. Personal data will be deleted continuously. ISO 8601 date format
organisationIdThe organisation the customer is registered with.
changedByChannelWhich sales channel or system who last changed the customer. Used for traceability in accordance with GDPR
createdByChannelWhich sales channel or system who created the customer. Used for traceability in accordance with GDPR
emailContact email.
The notes connected to the customer.
emailOldWhen customer is deleted (status='D'), the value of 'email' is moved here to allow creation of a new customer with the same email.
countryCodeTelephone number country code, starting with +.
customerRefOptional customer reference. Defaults to customer number if not set.
dateOfBirthDate of birth. ISO 8601 date format
dateOfDeathDate of death. ISO 8601 date format
nationalityThe customers nationality. ISO 3166-1 alpha-3 format
The preferences connected to the customer.
landlineNumberLandline telephone number.
emailVerifiedAtWhen the email was verified. ISO 8601 date format
The postal addresses connected to the customer.
telephoneNumberDeprecated. Please use countryCode and telephoneNumberNoCountryCode. Telephone number for customer. This should be a cell phone number.
The legacy consents connected to the customer.
customerAccountIdCustomer account id used for account based ticketing
telephoneNumberVerifiedAtWhen the telephone number was verified. ISO 8601 date format
telephoneNumberNoCountryCodeTelephone number without country code or punctuation.
The consents connected to the customer. Deprecated
Update temporary profile
Deprecated. Use /profiles/*. Updates the temporary customer profile with the value provided. All fields are overwritten.
path Parameters
customerNumberHeaders
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Update temporary profile › Request Body
changedByWho last changed the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
expirationDateThe date when the customers personal data should be deleted. Personal data will be deleted continuously. ISO 8601 date format
changedByChannelWhich sales channel or system who last changed the customer. Used for traceability in accordance with GDPR
emailContact email
surnameSurname.
firstNameFirst and middle name.
countryCodeTelephone number country code, starting with +.
dateOfBirthDate of birth. ISO 8601 date format
landlineNumberLandline telephone number.
telephoneNumberDeprecated. Please use countryCode and telephoneNumberNoCountryCode. Telephone number for customer. This should be a cell phone number.
telephoneNumberNoCountryCodeTelephone number without country code or punctuation.
customerAccountIdDeprecated. Use /profiles/{customerNumber}/customer-accounts. Customer account id used for account based ticketing
Update temporary profile › Responses
OK
uuidA universal unique id for the customer. 32 random alphanumeric characters. Not RFC 4122 compliant
statusCustomer status. Statuses supported: 'A' = Active, 'P' = Passive, 'D' = Deleted. Default is 'A'.
surnameSurname.
changedAtWhen the customer was last changed. ISO 8601 date format
changedByWho last changed the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
createdAtWhen the customer was created. ISO 8601 date format
createdByWho created the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
firstNameFirst and middle name.
customerNumberCustomer number.
expirationDateThe date when the customers personal data should be deleted. Personal data will be deleted continuously. ISO 8601 date format
organisationIdThe organisation the customer is registered with.
changedByChannelWhich sales channel or system who last changed the customer. Used for traceability in accordance with GDPR
createdByChannelWhich sales channel or system who created the customer. Used for traceability in accordance with GDPR
emailContact email.
The notes connected to the customer.
emailOldWhen customer is deleted (status='D'), the value of 'email' is moved here to allow creation of a new customer with the same email.
countryCodeTelephone number country code, starting with +.
customerRefOptional customer reference. Defaults to customer number if not set.
dateOfBirthDate of birth. ISO 8601 date format
dateOfDeathDate of death. ISO 8601 date format
nationalityThe customers nationality. ISO 3166-1 alpha-3 format
The preferences connected to the customer.
landlineNumberLandline telephone number.
emailVerifiedAtWhen the email was verified. ISO 8601 date format
The postal addresses connected to the customer.
telephoneNumberDeprecated. Please use countryCode and telephoneNumberNoCountryCode. Telephone number for customer. This should be a cell phone number.
The legacy consents connected to the customer.
customerAccountIdCustomer account id used for account based ticketing
telephoneNumberVerifiedAtWhen the telephone number was verified. ISO 8601 date format
telephoneNumberNoCountryCodeTelephone number without country code or punctuation.
The consents connected to the customer. Deprecated
Convert to permanent
Deprecated. Use /profiles/*. Converts the temporary customer profile to a permanent profile. Note that this is a one-way change, there is no going back. When converting, all fields not present in the temporary profile need to be supplied.
path Parameters
customerNumberHeaders
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Convert to permanent › Request Body
surnameSurname of the temporary customer to be converted to a permanent customer
changedByChangedBy of the temporary customer to be converted to a permanent customer
firstNameFirst name of the temporary customer to be converted to a permanent customer
changedByChannelChangedByChannel of the temporary customer to be converted to a permanent customer
emailOptional email of the temporary customer to be converted to a permanent customer
passwordPassword of the temporary customer to be converted to a permanent customer
customerRefOptional customer reference. Defaults to customer number if not set
organisationIdOrganisation id of the temporary customer to be converted to a permanent customer
Convert to permanent › Responses
OK
uuidA universal unique id for the customer. 32 random alphanumeric characters. Not RFC 4122 compliant
statusCustomer status. Statuses supported: 'A' = Active, 'P' = Passive, 'D' = Deleted. Default is 'A'.
surnameSurname.
changedAtWhen the customer was last changed. ISO 8601 date format
changedByWho last changed the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
createdAtWhen the customer was created. ISO 8601 date format
createdByWho created the customer. Either web, app or username of employee. Used for traceability in accordance with GDPR
firstNameFirst and middle name.
profileTypeType of profile. Types supported: 'S' = Standard customer, 'P' = Personnel ticket customer, 'T' = Temporary customer. Default is 'S'.
customerNumberCustomer number.
organisationIdThe organisation the customer is registered with.
changedByChannelWhich sales channel or system who last changed the customer. Used for traceability in accordance with GDPR
createdByChannelWhich sales channel or system who created the customer. Used for traceability in accordance with GDPR
emailContact email. May become different from username
vippsIdVipps unique user identifier
emailOldWhen customer is deleted (status='D'), the value of 'email' is moved here to allow creation of a new customer with the same email.
parentIdId of the parent customer. Used to connect different customer types.
usernameUsername the customer can use to log unto their profile. Only available on profile type S(tamkunde) and profile status A(ctive)
countryCodeTelephone number country code, starting with +.
customerRefOptional customer reference. Defaults to customer number if not set.
Date as object
Date as object
nationalityThe customers nationality. ISO 3166-1 alpha-3 format
The preferences connected to the customer.
lastSignInAtWhen the customer last signed in. ISO 8601 date format
expirationDateThe date when the customers personal data should be deleted. Personal data will be deleted continuously. ISO 8601 date format
landlineNumberLandline telephone number.
lastSignInFromWhere the customer last signed in from. Typically web or app. Typically used to display to the user where the last login was performed.
The ecards connected to the customer.
emailVerifiedAtWhen the email was verified. ISO 8601 date format
The postal addresses connected to the customer.
telephoneNumberDeprecated. Please use countryCode and telephoneNumberNoCountryCode. Telephone number for customer. This should be a cell phone number.
Customer accounts used for account based ticketing
The legacy consents connected to the customer.
customerAccountIdCustomer account id used for account based ticketing
The personnel tickets connected to the customer. Deprecated. Does not contain updated information.
relatedCustomerNumbersThe customer number of profiles which has been merged into the current profile. These may be used to lookup customer information in other systems
languagePreferenceISO6393Which language the customer wants information in. ISO 639-3 format. Default is 'NOB'.
telephoneNumberVerifiedAtWhen the telephone number was verified. ISO 8601 date format
telephoneNumberNoCountryCodeTelephone number without country code or punctuation.
idCustomer id. Deprecated
Deprecated. The notes connected to the customer.
The consents connected to the customer. Deprecated
languagePreferenceDeprecated, please use languagePreferenceISO6393. Which language the customer wants information in. Default is 'NO'.