Endpoints disponibles

Retrieve events

get

https://api.lavitrine.com/functions/v1/exit-apihttps://staging-api.lavitrine.com/functions/v1/exit-api

/events

Get a paginated list of events with various filtering options. Returns events in chronological order with detailed information including location, performers, and ticket offers. Each item includes visibility and inactivityReason properties.

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from the /login endpoint. The token must be included in the Authorization header as "Bearer ".

The token contains tenant information that is used to:

1. Validate the request's authorization
2. Set the tenant context for the request
3. Apply partner-specific configuration and access scopes

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

Query parameters

includeInactivebooleanOptional

When true, include inactive and past events in results. By default, only active events are returned. When filtering by ID, this is automatically set to true.

Default: false

idstringOptional

Filter by specific event ID. Automatically includes inactive events when used.

Example: evt-123abc

eventIdstringOptional

Filter by unique event identifier

typestringOptional

Filter by event type

Example: Concert

nameFrstringOptional

Filter by French name (partial match supported)

Example: Festival

nameEnstringOptional

Filter by English name (partial match supported)

Example: Festival

statusstring · enumOptional

Filter by event status

Possible values:

startDate_gtestring · date-timeOptional

Filter by start date greater than or equal to

Example: 2024-12-01T00:00:00Z

startDate_ltestring · date-timeOptional

Filter by start date less than or equal to

Example: 2024-12-31T23:59:59Z

endDate_gtestring · date-timeOptional

Filter by end date greater than or equal to

endDate_ltestring · date-timeOptional

Filter by end date less than or equal to

audiencestring · enumOptional

Filter by target audience

Possible values:

mainAdditionalTypeIdstringOptional

Filter by main additional type identifier

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

langstring · enumOptional

Language preference for response content

Default: frPossible values:

Responses

200

Successfully retrieved events

application/json

400

Bad request - invalid parameters or missing required fields

application/json

401

Unauthorized - invalid or missing authentication token

application/json

404

Resource not found

application/json

416

Pagination error - requested page number exceeds available range

application/json

500

Internal server error

application/json

get

/events

HTTPcURLJavaScriptPython

GET /functions/v1/exit-api/events HTTP/1.1
Host: api.lavitrine.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "@id": "/en/event/vendredis-de-poesie/22",
      "IDV1": 65186,
      "visibility": "active",
      "inactivityReason": null,
      "url": "text",
      "identifier": 22,
      "id": "text",
      "type": "text",
      "nameFr": "text",
      "nameEn": "text",
      "descriptionFr": "text",
      "descriptionEn": "text",
      "startDate": "2026-02-26T23:09:37.179Z",
      "endDate": "2026-02-26T23:09:37.179Z",
      "status": "text",
      "audience": "text",
      "location": {},
      "isAccessibleForFree": true,
      "image": {
        "url": "https://media.quebecspectacles.com/image/1693232905745.jpg",
        "title": "text",
        "mimetype": "text",
        "size": 1,
        "id": "text"
      },
      "sameAs": "text",
      "lastModifiedDate": "2026-02-26T23:09:37.179Z",
      "duration": "text",
      "inLanguage": "fr",
      "withoutWords": true,
      "eventAttendanceMode": "OfflineEventAttendanceMode",
      "eventStatus": "EventScheduled",
      "performers": [
        {
          "@type": "Person",
          "id": 1,
          "description": "text",
          "contribution": "text",
          "name": "text",
          "url": "text",
          "image": "text"
        }
      ],
      "organizers": [
        {}
      ],
      "offers": [
        {
          "id": 1,
          "IDV1": 1,
          "places_id": 1,
          "events_id": 1,
          "event_series_ids": [
            1
          ],
          "startDate": "2026-02-26T23:09:37.179Z",
          "endDate": "2026-02-26T23:09:37.179Z",
          "isAccessibleForFree": true,
          "url": "text",
          "priceSpecification": {},
          "visibility": "active",
          "inactivityReason": "text"
        }
      ],
      "mainKeyword": {
        "id": "keyword-123",
        "labelFr": "Jazz",
        "labelEn": "Jazz",
        "code": [
          "MUSIC",
          "JAZZ"
        ]
      },
      "otherKeywords": [
        {
          "id": "keyword-123",
          "labelFr": "Jazz",
          "labelEn": "Jazz",
          "code": [
            "MUSIC",
            "JAZZ"
          ]
        }
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "nextPageUrl": "text"
  }
}

Retrieve event series

get

https://api.lavitrine.com/functions/v1/exit-apihttps://staging-api.lavitrine.com/functions/v1/exit-api

/event-series

Get a paginated list of event series such as festivals, seasonal programs, and recurring events. Returns detailed information about series including dates, venues, and associated events. Each item includes visibility and inactivityReason properties.

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from the /login endpoint. The token must be included in the Authorization header as "Bearer ".

The token contains tenant information that is used to:

1. Validate the request's authorization
2. Set the tenant context for the request
3. Apply partner-specific configuration and access scopes

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

Query parameters

includeInactivebooleanOptional

When true, include inactive and past event series in results. By default, only active series are returned. When filtering by ID, this is automatically set to true.

Default: false

idstringOptional

Filter by specific event series ID. Automatically includes inactive series when used.

Example: series-123abc

nameFrstringOptional

Filter by French name (partial match supported)

Example: Festival d'été

nameEnstringOptional

Filter by English name (partial match supported)

Example: Summer Festival

created_atstring · date-timeOptional

Filter by creation date

Example: 2024-01-01T00:00:00Z

updated_atstring · date-timeOptional

Filter by last update date

Example: 2024-12-31T23:59:59Z

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

langstring · enumOptional

Language preference for response content

Default: frPossible values:

Responses

200

Successfully retrieved event series

application/json

400

Bad request - invalid parameters or missing required fields

application/json

401

Unauthorized - invalid or missing authentication token

application/json

404

Resource not found

application/json

416

Pagination error - requested page number exceeds available range

application/json

500

Internal server error

application/json

get

/event-series

HTTPcURLJavaScriptPython

GET /functions/v1/exit-api/event-series HTTP/1.1
Host: api.lavitrine.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "@context": "https://schema.org",
      "@type": "EventSeries",
      "visibility": "active",
      "inactivityReason": null,
      "id": "series-123abc",
      "nameFr": "Festival International de Jazz de Montréal 2024",
      "nameEn": "Montreal International Jazz Festival 2024",
      "descriptionFr": "Le plus grand festival de jazz au monde",
      "descriptionEn": "The world's largest jazz festival",
      "startDate": "2024-06-27T00:00:00Z",
      "endDate": "2024-07-06T23:59:59Z",
      "duration": "P10D",
      "audience": "General",
      "location": {
        "@context": "https://schema.org",
        "@type": "Place",
        "visibility": "active",
        "inactivityReason": null,
        "id": "place-123abc",
        "nameFr": "Théâtre du Nouveau Monde",
        "nameEn": "New World Theatre",
        "descriptionFr": "Un théâtre historique au cœur de Montréal",
        "descriptionEn": "A historic theatre in the heart of Montreal",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "84 Rue Sainte-Catherine O",
          "addressLocality": "Montréal",
          "addressRegion": "QC",
          "postalCode": "H2X 1Z6",
          "addressCountry": "CA"
        },
        "geo": {
          "@type": "GeoCoordinates",
          "latitude": 45.508888,
          "longitude": -73.567256
        },
        "maximumAttendeeCapacity": 500,
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/images/theatre.jpg"
        },
        "url": "https://www.theatre.example.com",
        "thumbnail": "https://example.com/thumbnails/theatre.jpg",
        "locationType": "text",
        "containedInPlace": 104,
        "containsPlace": [
          {
            "@context": "https://schema.org",
            "@type": "Place",
            "visibility": "active",
            "inactivityReason": null,
            "id": "place-123abc",
            "nameFr": "Théâtre du Nouveau Monde",
            "nameEn": "New World Theatre",
            "descriptionFr": "Un théâtre historique au cœur de Montréal",
            "descriptionEn": "A historic theatre in the heart of Montreal",
            "address": {
              "@type": "PostalAddress",
              "streetAddress": "84 Rue Sainte-Catherine O",
              "addressLocality": "Montréal",
              "addressRegion": "QC",
              "postalCode": "H2X 1Z6",
              "addressCountry": "CA"
            },
            "geo": {
              "@type": "GeoCoordinates",
              "latitude": 45.508888,
              "longitude": -73.567256
            },
            "maximumAttendeeCapacity": 500,
            "image": {
              "@type": "ImageObject",
              "url": "https://example.com/images/theatre.jpg"
            },
            "url": "https://www.theatre.example.com",
            "thumbnail": "https://example.com/thumbnails/theatre.jpg",
            "locationType": "text",
            "containedInPlace": 104,
            "containsPlace": "[Circular Reference]",
            "linkedPlaces": [
              {}
            ]
          }
        ],
        "linkedPlaces": [
          {}
        ]
      },
      "places_id": "place-456def",
      "offers": [
        {
          "price": 45,
          "priceCurrency": "CAD",
          "validFrom": "2024-04-01T00:00:00Z"
        }
      ],
      "exhibitions": [
        {
          "@context": "https://schema.org",
          "@type": "ExhibitionEvent",
          "visibility": "active",
          "inactivityReason": null,
          "id": "exhib-123abc",
          "exhibitionEventId": "CREME-VCM-EXHIBITION-123",
          "type": "Exhibition",
          "nameFr": "L'Art Moderne au Québec",
          "nameEn": "Modern Art in Quebec",
          "descriptionFr": "Une exposition fascinante sur l'art moderne québécois",
          "descriptionEn": "A fascinating exhibition on Quebec modern art",
          "startDate": "2024-03-01T10:00:00Z",
          "endDate": "2024-06-30T17:00:00Z",
          "status": "scheduled",
          "audience": "General",
          "isAccessibleForFree": false,
          "attendanceMode": "offline",
          "eventStatus": "EventScheduled",
          "location": {
            "@context": "https://schema.org",
            "@type": "Place",
            "visibility": "active",
            "inactivityReason": null,
            "id": "place-123abc",
            "nameFr": "Théâtre du Nouveau Monde",
            "nameEn": "New World Theatre",
            "descriptionFr": "Un théâtre historique au cœur de Montréal",
            "descriptionEn": "A historic theatre in the heart of Montreal",
            "address": {
              "@type": "PostalAddress",
              "streetAddress": "84 Rue Sainte-Catherine O",
              "addressLocality": "Montréal",
              "addressRegion": "QC",
              "postalCode": "H2X 1Z6",
              "addressCountry": "CA"
            },
            "geo": {
              "@type": "GeoCoordinates",
              "latitude": 45.508888,
              "longitude": -73.567256
            },
            "maximumAttendeeCapacity": 500,
            "image": {
              "@type": "ImageObject",
              "url": "https://example.com/images/theatre.jpg"
            },
            "url": "https://www.theatre.example.com",
            "thumbnail": "https://example.com/thumbnails/theatre.jpg",
            "locationType": "text",
            "containedInPlace": 104,
            "containsPlace": "[Circular Reference]",
            "linkedPlaces": [
              {}
            ]
          },
          "performer": [
            {
              "@type": "Person",
              "name": "Marie Artiste"
            }
          ],
          "organizer": [
            {
              "@type": "Organization",
              "name": "MAC Montréal"
            }
          ],
          "offers": [
            {
              "@type": "Offer",
              "price": 25,
              "priceCurrency": "CAD",
              "validFrom": "2024-02-01T00:00:00Z",
              "url": "https://example.com/tickets/123"
            }
          ],
          "mainKeyword": {
            "id": "keyword-123",
            "labelFr": "Jazz",
            "labelEn": "Jazz",
            "code": [
              "MUSIC",
              "JAZZ"
            ]
          },
          "otherKeywords": [
            {
              "id": "keyword-123",
              "labelFr": "Jazz",
              "labelEn": "Jazz",
              "code": [
                "MUSIC",
                "JAZZ"
              ]
            }
          ],
          "event_series_ids": [
            "text"
          ]
        }
      ],
      "type": "Festival",
      "image": {
        "@type": "ImageObject",
        "url": "https://example.com/images/festival.jpg",
        "title": "text",
        "mimetype": "text",
        "size": 1,
        "id": "text"
      },
      "sameAs": "text",
      "lastModifiedDate": "2026-02-26T23:09:37.179Z",
      "urlConstruct": {
        "fr": "https://example.com",
        "en": "https://example.com"
      },
      "mainKeyword": {
        "id": "keyword-123",
        "labelFr": "Jazz",
        "labelEn": "Jazz",
        "code": [
          "MUSIC",
          "JAZZ"
        ]
      }
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "nextPageUrl": "text"
  }
}

Retrieve exhibition events

get

https://api.lavitrine.com/functions/v1/exit-apihttps://staging-api.lavitrine.com/functions/v1/exit-api

/exhibition-events

Get a paginated list of exhibition events including art shows, museum exhibitions, and cultural displays. Returns detailed information about exhibitions including duration, location, and contributors. Each item includes visibility and inactivityReason properties.

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from the /login endpoint. The token must be included in the Authorization header as "Bearer ".

The token contains tenant information that is used to:

1. Validate the request's authorization
2. Set the tenant context for the request
3. Apply partner-specific configuration and access scopes

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

Query parameters

includeInactivebooleanOptional

When true, include inactive and past exhibition events in results. By default, only active exhibitions are returned. When filtering by ID, this is automatically set to true.

Default: false

idstringOptional

Filter by specific exhibition event ID. Automatically includes inactive exhibitions when used.

Example: exhib-123abc

exhibitionEventIdstringOptional

Filter by unique exhibition event identifier

Example: CREME-VCM-EXHIBITION-123

typestring · enumOptional

Filter by exhibition type

Possible values:

nameFrstringOptional

Filter by French name (partial match supported)

Example: Exposition

nameEnstringOptional

Filter by English name (partial match supported)

Example: Exhibition

statusstring · enumOptional

Filter by exhibition status

Possible values:

startDate_gtestring · date-timeOptional

Filter by start date greater than or equal to

Example: 2024-01-01T00:00:00Z

startDate_ltestring · date-timeOptional

Filter by start date less than or equal to

Example: 2024-12-31T23:59:59Z

endDate_gtestring · date-timeOptional

Filter by end date greater than or equal to

endDate_ltestring · date-timeOptional

Filter by end date less than or equal to

audiencestring · enumOptional

Filter by target audience

Possible values:

isAccessibleForFreebooleanOptional

Filter by free admission status

attendanceModestring · enumOptional

Filter by attendance mode

Possible values:

mainLocationIdstringOptional

Filter by main venue location ID

mainAdditionalTypeIdstringOptional

Filter by main additional type identifier

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

langstring · enumOptional

Language preference for response content

Default: frPossible values:

Responses

200

Successfully retrieved exhibition events

application/json

400

Bad request - invalid parameters or missing required fields

application/json

401

Unauthorized - invalid or missing authentication token

application/json

404

Resource not found

application/json

416

Pagination error - requested page number exceeds available range

application/json

500

Internal server error

application/json

get

/exhibition-events

HTTPcURLJavaScriptPython

GET /functions/v1/exit-api/exhibition-events HTTP/1.1
Host: api.lavitrine.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "@context": "https://schema.org",
      "@type": "ExhibitionEvent",
      "visibility": "active",
      "inactivityReason": null,
      "id": "exhib-123abc",
      "exhibitionEventId": "CREME-VCM-EXHIBITION-123",
      "type": "Exhibition",
      "nameFr": "L'Art Moderne au Québec",
      "nameEn": "Modern Art in Quebec",
      "descriptionFr": "Une exposition fascinante sur l'art moderne québécois",
      "descriptionEn": "A fascinating exhibition on Quebec modern art",
      "startDate": "2024-03-01T10:00:00Z",
      "endDate": "2024-06-30T17:00:00Z",
      "status": "scheduled",
      "audience": "General",
      "isAccessibleForFree": false,
      "attendanceMode": "offline",
      "eventStatus": "EventScheduled",
      "location": {
        "@context": "https://schema.org",
        "@type": "Place",
        "visibility": "active",
        "inactivityReason": null,
        "id": "place-123abc",
        "nameFr": "Théâtre du Nouveau Monde",
        "nameEn": "New World Theatre",
        "descriptionFr": "Un théâtre historique au cœur de Montréal",
        "descriptionEn": "A historic theatre in the heart of Montreal",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "84 Rue Sainte-Catherine O",
          "addressLocality": "Montréal",
          "addressRegion": "QC",
          "postalCode": "H2X 1Z6",
          "addressCountry": "CA"
        },
        "geo": {
          "@type": "GeoCoordinates",
          "latitude": 45.508888,
          "longitude": -73.567256
        },
        "maximumAttendeeCapacity": 500,
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/images/theatre.jpg"
        },
        "url": "https://www.theatre.example.com",
        "thumbnail": "https://example.com/thumbnails/theatre.jpg",
        "locationType": "text",
        "containedInPlace": 104,
        "containsPlace": [
          {
            "@context": "https://schema.org",
            "@type": "Place",
            "visibility": "active",
            "inactivityReason": null,
            "id": "place-123abc",
            "nameFr": "Théâtre du Nouveau Monde",
            "nameEn": "New World Theatre",
            "descriptionFr": "Un théâtre historique au cœur de Montréal",
            "descriptionEn": "A historic theatre in the heart of Montreal",
            "address": {
              "@type": "PostalAddress",
              "streetAddress": "84 Rue Sainte-Catherine O",
              "addressLocality": "Montréal",
              "addressRegion": "QC",
              "postalCode": "H2X 1Z6",
              "addressCountry": "CA"
            },
            "geo": {
              "@type": "GeoCoordinates",
              "latitude": 45.508888,
              "longitude": -73.567256
            },
            "maximumAttendeeCapacity": 500,
            "image": {
              "@type": "ImageObject",
              "url": "https://example.com/images/theatre.jpg"
            },
            "url": "https://www.theatre.example.com",
            "thumbnail": "https://example.com/thumbnails/theatre.jpg",
            "locationType": "text",
            "containedInPlace": 104,
            "containsPlace": "[Circular Reference]",
            "linkedPlaces": [
              {}
            ]
          }
        ],
        "linkedPlaces": [
          {}
        ]
      },
      "performer": [
        {
          "@type": "Person",
          "name": "Marie Artiste"
        }
      ],
      "organizer": [
        {
          "@type": "Organization",
          "name": "MAC Montréal"
        }
      ],
      "offers": [
        {
          "@type": "Offer",
          "price": 25,
          "priceCurrency": "CAD",
          "validFrom": "2024-02-01T00:00:00Z",
          "url": "https://example.com/tickets/123"
        }
      ],
      "mainKeyword": {
        "id": "keyword-123",
        "labelFr": "Jazz",
        "labelEn": "Jazz",
        "code": [
          "MUSIC",
          "JAZZ"
        ]
      },
      "otherKeywords": [
        {
          "id": "keyword-123",
          "labelFr": "Jazz",
          "labelEn": "Jazz",
          "code": [
            "MUSIC",
            "JAZZ"
          ]
        }
      ],
      "event_series_ids": [
        "text"
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "nextPageUrl": "text"
  }
}

Retrieve places and venues

get

https://api.lavitrine.com/functions/v1/exit-apihttps://staging-api.lavitrine.com/functions/v1/exit-api

/places

Get a paginated list of cultural venues and places. Returns detailed information including address, geolocation, capacity, and associated events. Each item includes visibility and inactivityReason properties.

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from the /login endpoint. The token must be included in the Authorization header as "Bearer ".

The token contains tenant information that is used to:

1. Validate the request's authorization
2. Set the tenant context for the request
3. Apply partner-specific configuration and access scopes

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

Query parameters

includeInactivebooleanOptional

When true, include inactive places in results. By default, only active places are returned. When filtering by ID, this is automatically set to true.

Default: false

idstringOptional

Filter by specific place ID. Automatically includes inactive places when used.

Example: place-123abc

nameFrstringOptional

Filter by French name (partial match supported)

Example: Théâtre

nameEnstringOptional

Filter by English name (partial match supported)

Example: Theatre

created_atstring · date-timeOptional

Filter by creation date

Example: 2024-01-01T00:00:00Z

updated_atstring · date-timeOptional

Filter by last update date

Example: 2024-12-01T00:00:00Z

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

langstring · enumOptional

Language preference for response content

Default: frPossible values:

Responses

200

Successfully retrieved places

application/json

400

Bad request - invalid parameters or missing required fields

application/json

401

Unauthorized - invalid or missing authentication token

application/json

404

Resource not found

application/json

416

Pagination error - requested page number exceeds available range

application/json

500

Internal server error

application/json

get

/places

HTTPcURLJavaScriptPython

GET /functions/v1/exit-api/places HTTP/1.1
Host: api.lavitrine.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "@context": "https://schema.org",
      "@type": "Place",
      "visibility": "active",
      "inactivityReason": null,
      "id": "place-123abc",
      "nameFr": "Théâtre du Nouveau Monde",
      "nameEn": "New World Theatre",
      "descriptionFr": "Un théâtre historique au cœur de Montréal",
      "descriptionEn": "A historic theatre in the heart of Montreal",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "84 Rue Sainte-Catherine O",
        "addressLocality": "Montréal",
        "addressRegion": "QC",
        "postalCode": "H2X 1Z6",
        "addressCountry": "CA"
      },
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": 45.508888,
        "longitude": -73.567256
      },
      "maximumAttendeeCapacity": 500,
      "image": {
        "@type": "ImageObject",
        "url": "https://example.com/images/theatre.jpg"
      },
      "url": "https://www.theatre.example.com",
      "thumbnail": "https://example.com/thumbnails/theatre.jpg",
      "locationType": "text",
      "containedInPlace": 104,
      "containsPlace": [
        {
          "@context": "https://schema.org",
          "@type": "Place",
          "visibility": "active",
          "inactivityReason": null,
          "id": "place-123abc",
          "nameFr": "Théâtre du Nouveau Monde",
          "nameEn": "New World Theatre",
          "descriptionFr": "Un théâtre historique au cœur de Montréal",
          "descriptionEn": "A historic theatre in the heart of Montreal",
          "address": {
            "@type": "PostalAddress",
            "streetAddress": "84 Rue Sainte-Catherine O",
            "addressLocality": "Montréal",
            "addressRegion": "QC",
            "postalCode": "H2X 1Z6",
            "addressCountry": "CA"
          },
          "geo": {
            "@type": "GeoCoordinates",
            "latitude": 45.508888,
            "longitude": -73.567256
          },
          "maximumAttendeeCapacity": 500,
          "image": {
            "@type": "ImageObject",
            "url": "https://example.com/images/theatre.jpg"
          },
          "url": "https://www.theatre.example.com",
          "thumbnail": "https://example.com/thumbnails/theatre.jpg",
          "locationType": "text",
          "containedInPlace": 104,
          "containsPlace": [
            "[Circular Reference]"
          ],
          "linkedPlaces": [
            {}
          ]
        }
      ],
      "linkedPlaces": [
        {}
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "nextPageUrl": "text"
  }
}

Retrieve contributors information

get

https://api.lavitrine.com/functions/v1/exit-apihttps://staging-api.lavitrine.com/functions/v1/exit-api

/contributors

Get a paginated list of contributors including artists, organizers, and producers. Returns detailed information about people and organizations involved in cultural events. Each item includes visibility and inactivityReason properties.

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from the /login endpoint. The token must be included in the Authorization header as "Bearer ".

The token contains tenant information that is used to:

1. Validate the request's authorization
2. Set the tenant context for the request
3. Apply partner-specific configuration and access scopes

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

Query parameters

includeInactivebooleanOptional

When true, include inactive contributors in results. By default, only active contributors are returned. When filtering by ID, this is automatically set to true.

Default: false

idstringOptional

Filter by specific contributor ID. Automatically includes inactive contributors when used.

Example: cont-123abc

nameFrstringOptional

Filter by French name (partial match supported)

Example: Jean

nameEnstringOptional

Filter by English name (partial match supported)

Example: John

contributorTypestring · enumOptional

Filter by contributor type

Example: ArtistPossible values:

statusstring · enumOptional

Filter by contributor status

Possible values:

audiencestring · enumOptional

Filter by target audience

Possible values:

mainAdditionalTypeIdstringOptional

Filter by main additional type identifier

createdAt_gtestring · date-timeOptional

Filter by creation date greater than or equal to

Example: 2024-01-01T00:00:00Z

createdAt_ltestring · date-timeOptional

Filter by creation date less than or equal to

Example: 2024-12-31T23:59:59Z

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

langstring · enumOptional

Language preference for response content

Default: frPossible values:

Responses

200

Successfully retrieved contributors

application/json

400

Bad request - invalid parameters or missing required fields

application/json

401

Unauthorized - invalid or missing authentication token

application/json

404

Resource not found

application/json

416

Pagination error - requested page number exceeds available range

application/json

500

Internal server error

application/json

get

/contributors

HTTPcURLJavaScriptPython

GET /functions/v1/exit-api/contributors HTTP/1.1
Host: api.lavitrine.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "@context": "https://schema.org",
      "@type": "Person",
      "visibility": "active",
      "inactivityReason": null,
      "id": "artist-123",
      "contributorType": "Artist",
      "nameFr": "Marie Dubois",
      "nameEn": "Marie Dubois",
      "descriptionFr": "Artiste de jazz contemporain",
      "descriptionEn": "Contemporary jazz artist",
      "mainAdditionalTypeId": "jazz-musician",
      "image": {
        "@type": "ImageObject",
        "url": "https://example.com/artists/marie.jpg"
      },
      "url": "https://example.com",
      "address": {
        "unitAddress": "text",
        "streetAddress": "text",
        "streetType": "text",
        "streetName": "text",
        "streetDirection": "text",
        "addressLocality": "text",
        "addressRegion": "text",
        "postalCode": "text",
        "addressCountry": "text",
        "formattedAddress": "text",
        "_geoloc": {
          "lat": 1,
          "lng": 1
        }
      },
      "events": [
        {
          "id": "evt-789",
          "type": "MusicEvent",
          "name": "Jazz Festival 2024",
          "startDate": "2024-07-01T20:00:00Z"
        }
      ],
      "source": "text",
      "sourceId": "text",
      "contributorId": "text",
      "createdAt": "2026-02-26T23:09:37.179Z",
      "lastModification": "2026-02-26T23:09:37.179Z",
      "affiliationIds": [
        "text"
      ],
      "otherAdditionalTypeIds": [
        "text"
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "nextPageUrl": "text"
  }
}

Retrieve keywords and tags

get

https://api.lavitrine.com/functions/v1/exit-apihttps://staging-api.lavitrine.com/functions/v1/exit-api

/keywords

Get a paginated list of keywords and tags used for categorizing cultural content. Returns a hierarchical structure of keywords with detailed information including:

• Schema.org structured data (@context, @type, @id)

• Labels in French and English

• Associated codes for categorization

• Hierarchical relationships (parent-child structure)

• Metadata like creation and update timestamps

• Legacy IDs and identifiers

• Image and sameAs references

Keywords are filtered to show only active (non-archived) items from the V1TaxoDiscVitrine vocabulary. The response follows Schema.org DefinedTerm structure for semantic web compatibility.

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from the /login endpoint. The token must be included in the Authorization header as "Bearer ".

The token contains tenant information that is used to:

1. Validate the request's authorization
2. Set the tenant context for the request
3. Apply partner-specific configuration and access scopes

If the token is missing or invalid, the request will be rejected with a 401 Unauthorized response.

Query parameters

idstringOptional

Filter by specific keyword ID (exact match)

Example: 245

labelFrstringOptional

Filter by French label (exact match)

Example: Salons et démonstrations

labelEnstringOptional

Filter by English label (exact match)

Example: Exhibits and demonstrations

codestringOptional

Filter by keyword code (exact match)

Example: D-SalonDemonstrations

created_atstring · date-timeOptional

Filter by creation date (exact match)

Example: 2024-01-01T00:00:00Z

updated_atstring · date-timeOptional

Filter by last update date (exact match)

Example: 2024-07-06T16:37:24.40074

pageinteger · min: 1Optional

Page number for pagination (1-based indexing)

Default: 1Example: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page (maximum 100)

Default: 20Example: 30

langstring · enumOptional

Language preference for response content and metadata

Default: frExample: frPossible values:

Responses

200

Successfully retrieved keywords

application/json

400

Bad request - invalid parameters or missing required fields

application/json

401

Unauthorized - invalid or missing authentication token

application/json

404

Resource not found

application/json

416

Pagination error - requested page number exceeds available range

application/json

500

Internal server error

application/json

get

/keywords

HTTPcURLJavaScriptPython

GET /functions/v1/exit-api/keywords HTTP/1.1
Host: api.lavitrine.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "@context": "https://schema.org",
      "@type": "DefinedTerm",
      "@id": "/additionalTypes/245",
      "IDV1": null,
      "identifier": "245",
      "image": {},
      "sameAs": [],
      "lastModifiedDate": "2024-07-06T16:37:24.40074",
      "code": "D-SalonDemonstrations",
      "labelFr": "Salons et démonstrations",
      "labelEn": "Exhibits and demonstrations",
      "children": []
    }
  ],
  "pagination": {
    "total": 25,
    "page": 1,
    "limit": 30,
    "totalPages": 1,
    "nextPageUrl": null
  }
}