Add legitimation

POST{{API_BASE_URL}}/shop/v1/cart/:cart/legitimation/:legitimation

This endpoint is used to submit legitimation proofs for a specific cart and legitimation.

Request

proofs (array of objects)
- typeId (string): The ID of the proof type
- documentType (string): Type of the document, e.g., passport, driver's license
- value (string): Value of the document, e.g., document number, ID

Response

Upon successful submission, the response will contain the following data:

legitimationAdded (object)
- successful (boolean): Indicates if the legitimation proof submission was successful
- cartId (string): The ID of the cart
- legitimationIdentifier (object)
  - legitimationCategoryId (string): The ID of the legitimation category
  - identifier (string): Identifier of the legitimation
  - type (string): Type of the legitimation
cart (object): detailed information about the cart, including user details, event details, items in the cart, buyer information, legitimation details, and more.

Authentication#auth

This endpoint does not require authentication.

Query parameters#query

$expandAlloptional

—

Responses#responses

200OKAdd legitimation

Request

curl -X POST '{{API_BASE_URL}}/shop/v1/cart/:cart/legitimation/:legitimation' \
  -H 'Content-Type: application/json' \
  --data '{
    "proofs": [
        {
            "typeId": "{{PROOF_TYPE_ID}}",
            "documentType" : "Text",
            "value": "Text"
         }
    ]
}'

Body

application/json

{

"proofs": [

0: {

"typeId": "{{PROOF_TYPE_ID}}",

"documentType": "Text",

"value": "Text"

}

]

}

Sample response

200 OK

{

"data": {

"legitimationAdded": {

"successful": true,

"cartId": "0215c083-6e11-479e-a107-46da38760796",

"legitimationIdentifier": {

"legitimationCategoryId": "b2ee75eb-f1e1-ee11-93d5-00155d96040a",

"identifier": "a.greve@aditus.de",

"type": "Email"

}

},

"cart": {

"id": "0215c083-6e11-479e-a107-46da38760796",

"expiryTime": "2025-08-31T23:59:00+02:00",

"user": {

"id": "6fb0849c-1b89-ee11-93cf-00155d960409",

"isVerified": true,

"eMail": "a.greve@aditus.de"

},

"event": {

"id": "f32adbb6-3c9c-ef11-93d8-00155d96040a",

"name": "Futurama",

"year": "2025",

"number": "0815",

"slug": "fr25"

},

"promotionCodes": [

],

"items": [

0: {

"id": "004930c8-0000-0000-0000-000000000000",

"article": {

"id": "12b5a1e1-9304-f011-93dd-00155d96040a",

"name": "Futurama Legitimationsticket",

"internalName": "Futurama Legitimationsticket",

"description": null,

"sort": 0,

"prices": [

0: {

"price": {

"price": 12.61,

"grossPrice": 15,

"tax": 2.39,

"taxRate": 19,

"currency": "EUR"

},

"originalPrice": {

"price": 12.61,

"grossPrice": 15,

"tax": 2.39,

"taxRate": 19,

"currency": "EUR"

}

}

],

"image": {

"key": "Default.ExhibitorTicket",

"uri": "https://experiencedays.aditus.org/ADITUS-DEV-0_API/api/theme/v1/Images/Shop/ArticleImage/Default/ExhibitorTicket?context=article:12b5a1e1-9304-f011-93dd-00155d96040a&language=de&foregroundColor=%23C32826",

"type": "Icon"

},

"type": "VisitorTicket",

"ticketValidity": "OneDay",

"articleNumber": "820",

"category": null,

"legitimationCategory": {

"id": "b2ee75eb-f1e1-ee11-93d5-00155d96040a",

"name": "Fachbesucher",

"description": "Legitimation von Fachbesuchern",

"availableProofTypes": [

0: {

"id": "7f2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Persönliche Fachbesucherlegitimation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

1: {

"id": "7b2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Gewerbeanmeldung",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

2: {

"id": "802e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Studentenausweis/Immatrikulation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

3: {

"id": "7d2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Legitimation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

4: {

"id": "792e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Arbeitsvertrag",

"description": "Beschreibung Arbeitsvertrag",

"isRequired": false,

"availableDocumentTypes": [

0: "File"

]

},

5: {

"id": "7e2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Mitarbeiterlegitimation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

6: {

"id": "7a2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Gehaltsabrechnung",

"description": "Beschreibung Gehaltsabrechnung",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

7: {

"id": "7c2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Handelsregister",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

}

],

"proofUploadLimit": 3

},

"configuration": {

"showRemainingAmount": false,

"showRemainingAmountPerTimeslot": false,

"showIfSoldOut": false,

"soldOutText": null,

"maxLengthOfDescription": 250,

"maxNumberOfTicketsPerSale": null,

"minNumberOfTicketsPerSale": null,

"isInvitationEmailAddressChangePossible": true

},

"articleGroup": {

"id": "d4b0cf77-dd0a-f011-93dd-00155d96040a",

"name": "Futurama Special - Allgemein",

"sort": 0,

"configuration": {

"maxNumberOfTicketsPerSale": null,

"isExclusiveAssortment": false

}

}

},

"promotionCodes": [

],

"voucherCode": null,

"price": {

"price": 12.61,

"grossPrice": 15,

"tax": 2.39,

"taxRate": 19,

"currency": "EUR"

},

"registration": {

"data": {

"type": "self",

"referencedSurveyResponse": null,

"answers": [

0: {

"isReadOnly": false,

"bindingMember": "[CRM.Persons].SalutationLookup",

"value": "Frau"

},

1: {

"isReadOnly": false,

"bindingMember": "[CRM.Persons].FirstName",

"value": "Martina"

},

2: {

"isReadOnly": false,

"bindingMember": "[CRM.Persons].LastName",

"value": "Musterfrau"

},

3: {

"isReadOnly": false,

"bindingMember": "[CRM.Persons].Info1",

"value": "ADITUS GMBH"

},

4: {

"isReadOnly": false,

"bindingMember": "[CRM.PartyAddresses].CountryLookup",

"value": "DE"

},

5: {

"isReadOnly": false,

"bindingMember": "[CRM.PartyAddresses].Street",

"value": "Straße der Nationen"

},

6: {

"isReadOnly": false,

"bindingMember": "[CRM.PartyAddresses].StreetNumber",

"value": "5"

},

7: {

"isReadOnly": false,

"bindingMember": "[CRM.PartyAddresses].PostalCode",

"value": "12345"

},

8: {

"isReadOnly": false,

"bindingMember": "[CRM.PartyAddresses].City",

"value": "Hannover"

},

9: {

"isReadOnly": false,

"bindingMember": "[CRM.Persons].Info10",

"value": "0167"

},

10: {

"isReadOnly": false,

"bindingMember": "[CRM.PartyAddresses].County",

"value": "011"

}

],

"hasInformation": true

},

"isValid": true,

"problems": [

],

"isRequired": true,

"isPossible": true,

"types": {

"self": {

"isPossible": true,

"survey": "eyJVc2VDYXNlTmFtZSI6IlNob3AuUmVnaXN0cmF0aW9uLlNlbGYiLCJUZXJtaW5hbFNldElkIjpudWxsLCJGYWlyZXZlbnRJZCI6MTEzLCJSb2xlSWQiOm51bGwsIkFydGljbGVJZHMiOlsyNzU4XX0=",

"hasToBeCompletedByTicketOwnerHimself": true

},

"thirdPerson": {

"isPossible": true,

"survey": "eyJVc2VDYXNlTmFtZSI6IlNob3AuUmVnaXN0cmF0aW9uLlRoaXJkUGVyc29uQnlIaW1zZWxmIiwiVGVybWluYWxTZXRJZCI6bnVsbCwiRmFpcmV2ZW50SWQiOjExMywiUm9sZUlkIjpudWxsLCJBcnRpY2xlSWRzIjpbMjc1OF19",

"hasToBeCompletedByTicketOwnerHimself": true

}

}

},

"legitimation": {

"isRequired": true,

"isIncomplete": false,

"id": "eyJMZWdpdGltYXRpb25DYXRlZ29yeUlkIjoiYjJlZTc1ZWItZjFlMS1lZTExLTkzZDUtMDAxNTVkOTYwNDBhIiwiSWRlbnRpZmllciI6ImEuZ3JldmVAYWRpdHVzLmRlIiwiVHlwZSI6MX0="

},

"timeslots": {

"isEnabled": false,

"isValid": true,

"bookings": [

]

}

}

],

"totals": [

0: {

"original": {

"price": 12.61,

"grossPrice": 15,

"tax": 2.39,

"taxRate": 19,

"currency": "EUR"

},

"price": 12.61,

"grossPrice": 15,

"tax": 2.39,

"taxRate": 19,

"currency": "EUR"

}

],

"isImmutable": false,

"isPaymentImmutable": false,

"isLegitimationImmutable": false,

"isRegistrationImmutable": false,

"isAmountImmutable": false,

"isRegistrationOnly": false,

"isRegistrationRequired": true,

"isLegitimationRequired": true,

"isPaymentRequired": false,

"buyerPerson": {

"email": "a.greve@aditus.de",

"firstName": "Martina",

"lastName": "Musterfrau",

"company": "ADITUS GMBH",

"salutation": "Frau",

"vatId": null,

"address": {

"street": "Straße der Nationen",

"houseNumber": "5",

"postalCode": "12345",

"city": "Hannover",

"county": "011",

"country": "DE"

},

"isPrefilled": true,

"surveyId": "eyJVc2VDYXNlTmFtZSI6IlNob3AuTWlzc2luZ0J1eWVyIiwiVGVybWluYWxTZXRJZCI6bnVsbCwiRmFpcmV2ZW50SWQiOjExMywiUm9sZUlkIjpudWxsLCJBcnRpY2xlSWRzIjpbXX0=",

"isValid": true

},

"legitimations": [

0: {

"id": "eyJMZWdpdGltYXRpb25DYXRlZ29yeUlkIjoiYjJlZTc1ZWItZjFlMS1lZTExLTkzZDUtMDAxNTVkOTYwNDBhIiwiSWRlbnRpZmllciI6ImEuZ3JldmVAYWRpdHVzLmRlIiwiVHlwZSI6MX0=",

"category": {

"id": "b2ee75eb-f1e1-ee11-93d5-00155d96040a",

"name": "Fachbesucher",

"description": "Legitimation von Fachbesuchern",

"availableProofTypes": [

0: {

"id": "7f2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Persönliche Fachbesucherlegitimation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

1: {

"id": "7b2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Gewerbeanmeldung",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

2: {

"id": "802e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Studentenausweis/Immatrikulation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

3: {

"id": "7d2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Legitimation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

4: {

"id": "792e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Arbeitsvertrag",

"description": "Beschreibung Arbeitsvertrag",

"isRequired": false,

"availableDocumentTypes": [

0: "File"

]

},

5: {

"id": "7e2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Mitarbeiterlegitimation",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

6: {

"id": "7a2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Gehaltsabrechnung",

"description": "Beschreibung Gehaltsabrechnung",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

},

7: {

"id": "7c2e14d5-d5fb-ee11-93d5-00155d96040a",

"name": "Handelsregister",

"description": "",

"isRequired": false,

"availableDocumentTypes": [

0: "Url",

1: "File",

2: "Text"

]

}

],

"proofUploadLimit": 3

},

"associatedPerson": {

"salutation": null,

"firstName": null,

"lastName": null,

"email": "a.greve@aditus.de"

},

"proofs": [

0: {

"typeId": "7d2e14d5-d5fb-ee11-93d5-00155d96040a",

"documentType": "Text",

"value": "Text"

}

]

}

],

"status": "Active",

"culture": "de"

}

}

}