# Referanse

<!-- GENERERT av scripts/generate-api-reference.js fra docs/graphql-schema.graphql og docs/graphql-descriptions.nb.json. Ikke rediger for hånd. -->

Hver type i GraphQL-API-et til TRD Events, med beskrivelsene tjeneren selv bærer, oversatt fra engelsk.
Det samme skjemaet finnes ordrett som [schema.graphql](https://trdevents.no/utviklere/schema.graphql) og gjennom
introspeksjon på `https://trdevents.no/graphQL`. Hvordan det brukes — datoer, identifikatorer, paginering, feil — står på
[API-siden](/utviklere/api).

Kategori-id-er er per lisens: der en beskrivelse sier `<CATEGORY_IDS>`, er listen for denne kalenderen
den `categories` returnerer (også skrevet ut på API-siden).

Det finnes ingen `Mutation`-type: API-et er skrivebeskyttet.

## Query

### `events(filter: Filter, page: Int, pageSize: Int): EventConnection`

Hent alle arrangementer som oppfyller kriteriene i filteret. page (standard 0) og pageSize (standard 10) er valgfrie for paginering.

| Argument | Type | Beskrivelse |
|---|---|---|
| `filter` | `Filter` |  |
| `page` | `Int` |  |
| `pageSize` | `Int` |  |

### `eventByID(eventID: String!): Event`

Hent et arrangement etter arrangements-ID

| Argument | Type | Beskrivelse |
|---|---|---|
| `eventID` | `String!` |  |

### `eventsBySlugs(eventsSlugs: [String]!): [Event]`

Hent arrangementer etter slugene deres

| Argument | Type | Beskrivelse |
|---|---|---|
| `eventsSlugs` | `[String]!` |  |

### `eventBySlug(eventSlug: String!): Event`

Hent et arrangement etter slug (den unike identifikatoren som står i URL-en)

| Argument | Type | Beskrivelse |
|---|---|---|
| `eventSlug` | `String!` |  |

### `eventByTitle(title: String!, lan: String!): Event`

Hent et arrangement etter tittel. 'lan' er 'nb' eller 'en'

| Argument | Type | Beskrivelse |
|---|---|---|
| `title` | `String!` |  |
| `lan` | `String!` |  |

### `allUpcomingSuperEvents: [Event]`

Hent alle kommende (eller pågående) overordnede arrangementer

### `allUpcomingEventsInArea(minLatitude: Float!, maxLatitude: Float!, minLongitude: Float!, maxLongitude: Float!): [Event]`

Hent alle kommende arrangementer innenfor et rektangulært område.

| Argument | Type | Beskrivelse |
|---|---|---|
| `minLatitude` | `Float!` |  |
| `maxLatitude` | `Float!` |  |
| `minLongitude` | `Float!` |  |
| `maxLongitude` | `Float!` |  |

### `categories: [Category]`

Hent alle kategoriene

### `venues: [Venue]`

Hent alle stedene

### `organizers: [Organizer]`

Hent alle arrangørene

## type CategoriesInfo

| Felt | Type | Beskrivelse |
|---|---|---|
| `category` | `String` |  |
| `hits` | `Int` |  |

## type Category

| Felt | Type | Beskrivelse |
|---|---|---|
| `id` | `ID` |  |
| `name_en` | `String` |  |
| `name_nb` | `String` |  |
| `slug_en` | `String` |  |
| `slug_nb` | `String` |  |
| `visible` | `Boolean` |  |
| `subcategories` | `[Category]` |  |

## type Event

| Felt | Type | Beskrivelse |
|---|---|---|
| `activeTickets` | `Int` | Totalt antall aktive billetter akkurat nå, dersom arrangementet har påmelding |
| `ageRestriction` | `String!` | Mulige verdier: no-restriction, minimum-age eller maximum-age |
| `availableTickets` | `Int` | Antall tilgjengelige billetter for et arrangement |
| `author_id` | `ID!` | ID-en til brukeren som opprettet arrangementet |
| `cancellationPeriod` | `Int` | Antall dager før arrangementet starter som en billett kan avbestilles |
| `categories` | `[String]!` | Arrangementets kategorier |
| `created_at` | `String` | Opprettelsesdato for arrangementsforekomsten i ISO-format. Eksempel: 2020-10-21 23:00:00+00 |
| `desc_en` | `String` | Beskrivelse av arrangementet på engelsk. Kan være null eller tom |
| `desc_nb` | `String` | Beskrivelse av arrangementet på norsk. Kan være null eller tom |
| `duration` | `Int` | Arrangementets varighet i minutter |
| `editableBy` | `String` | Rettigheter til å redigere arrangementet. Mulige verdier: only-me eller en team-ID |
| `embeddedVideoURL` | `String` | Video-URL fra YouTube eller Vimeo som bygges inn på arrangementets detaljside |
| `endDate` | `String!` | Sluttdato og -tid for arrangementsforekomsten, i norsk lokal tid med UTC-forskyvningen som gjelder PÅ DEN DATOEN: +02:00 i sommertid, +01:00 i vintertid. Format: YYYY-MM-DD HH:mm:ss+HH:mm — merk MELLOMROMMET som skilletegn; dette er ikke RFC 3339, så en streng ISO-parser avviser det. Vis det i Europe/Oslo; formatering i tjenerens egen sone forskyver klokka, og forskyvningen endres ved hver overgang til og fra sommertid. Eksempel: 2026-11-01 10:00:00+01:00 |
| `eventCancelled` | `Boolean` | Angir om arrangementet er avlyst |
| `eventSoldOut` | `Boolean` | Angir om arrangementet er utsolgt |
| `event_slug` | `String!` | Arrangementets slug. Brukes til å bygge lenken til arrangementet |
| `eventLink` | `String!` | Lenke til arrangementet |
| `eventVMFest` | `Boolean` | UTGÅTT: Bruk isFeaturedSpecialEvent i stedet. Returnerer alltid false. |
| `facebookURL` | `String` | URL til Facebook-arrangementet |
| `id` | `ID!` | Arrangementets unike id |
| `images` | `[Image]` | Arrangementets bilder |
| `isImported` | `Boolean` | True når arrangementet ble importert fra en ekstern feed. Lar aggregatorer hoppe over ny innhenting av feed-importerte arrangementer (vern mot tilbakekoblingssløyfe) uten å avsløre interne feed-id-er. Arrangementer opprettet av mennesker og synkronisert fra en annen HSK-kalender flagges IKKE. |
| `isFeaturedEvent` | `Boolean` | Angir om oppretteren har fremhevet arrangementet |
| `isFeaturedSpecialEvent` | `Boolean` | Angir om arrangementet er fremhevet i et spesialarrangement |
| `isFeaturedVMFestEvent` | `Boolean` | UTGÅTT: Bruk isFeaturedSpecialEvent i stedet. Peker til isFeaturedSpecialEvent for bakoverkompatibilitet. |
| `maximumAge` | `Int` | Øvre aldersgrense (i år) for adgang til arrangementet |
| `minimumAge` | `Int` | Nedre aldersgrense (i år) for adgang til arrangementet |
| `maxBookingDate` | `String` | Siste dato for bestilling av billetter (kan være null) |
| `maxBookingTime` | `String` | Siste klokkeslett for bestilling av billetter (format HH:mm) |
| `mode` | `String` | Angir arrangementets form. Mulige verdier: offline eller online |
| `moreInfoURL` | `String` | URL med mer informasjon om arrangementet |
| `organizers` | `[Organizer]!` | Arrangementets arrangør(er) |
| `paymentMethod` | `String` | Betalingsmåte for billettene til et arrangement: door (i døra) eller invoice (faktura) |
| `publishingDate` | `String` | Publiseringsdato for arrangementsforekomsten i ISO-format. Eksempel: 2020-10-21 23:00:00+00 |
| `prices` | `[Price]` | Priser for arrangementet dersom det ikke er gratis |
| `registrationEnabled` | `Boolean` | Om brukere kan melde seg på via dette nettstedet |
| `repetitions` | `[Repetition]` | Arrangementets gjentakelser |
| `startDate` | `String!` | Startdato og -tid for arrangementsforekomsten, i norsk lokal tid med UTC-forskyvningen som gjelder PÅ DEN DATOEN: +02:00 i sommertid, +01:00 i vintertid. Format: YYYY-MM-DD HH:mm:ss+HH:mm — merk MELLOMROMMET som skilletegn; dette er ikke RFC 3339, så en streng ISO-parser avviser det. Vis det i Europe/Oslo; formatering i tjenerens egen sone forskyver klokka, og forskyvningen endres ved hver overgang til og fra sommertid. For bare klokkeslettet, bruk startTime. Eksempel: 2026-11-01 10:00:00+01:00 |
| `startTime` | `String` | Starttidspunkt for arrangementsforekomsten. Eksempel: 14:00 |
| `streamingURL` | `String` | URL til strømmingen av et nettarrangement |
| `super_event` | `String` | ID-en til det overordnede arrangementet (beholderen) hvis det finnes (en festival, et marked osv.) |
| `tags` | `String` | Stikkord knyttet til arrangementet (kommaseparerte verdier) |
| `ticketsFromDate` | `String` | Dato billettene blir tilgjengelige for publikum |
| `ticketsFromTime` | `String` | Klokkeslett billettene blir tilgjengelige for publikum |
| `ticketsInformation` | `String` | Informasjon om arrangementets billetter. Mulige verdier: 'free', 'noTicketsInfo' eller 'ticketsInfo' |
| `ticketsURL` | `String` | URL for kjøp av billetter til arrangementet |
| `title_en` | `String` | Arrangementets tittel på engelsk. Kan være null eller tom |
| `title_nb` | `String!` | Arrangementets tittel på norsk |
| `translationMeta` | `TranslationMeta` | Metadata om hvilke felt som er maskinoversatt |
| `type` | `String` | Arrangementstype. Mulige verdier: orphan, has-super eller super-event |
| `updated_at` | `String` | Tidspunkt for siste oppdatering av arrangementsforekomsten i ISO-format. Eksempel: 2020-10-21 23:00:00+00 |
| `venue` | `Venue` | Arrangementets sted. Kan være null hvis arrangementet er på nett |
| `venueNote` | `String` | Relevant informasjon om arrangementets sted |
| `videosURL` | `String` | URL til videoer fra arrangementet. |
| `views` | `Int` | Antall visninger av arrangementet. |

## type EventConnection

| Felt | Type | Beskrivelse |
|---|---|---|
| `totalCount` | `Int` |  |
| `hasMore` | `Boolean` |  |
| `data` | `[Event]` |  |
| `pageInfo` | `PageInfo` |  |
| `venues` | `[VenuesInfo]` |  |
| `organizers` | `[OrganizersInfo]` |  |
| `categories` | `[CategoriesInfo]` |  |

## input Filter

| Felt | Type | Beskrivelse |
|---|---|---|
| `categories` | `[String]` | Arrangementer med en av de oppgitte kategoriene. Tom liste tilsvarer alle kategorier. Mulige verdier: <CATEGORY_IDS: per lisens, se assets/data/categories.json> |
| `fromDate` | `String` | Arrangementer som pågår på denne datoen eller senere. Standard er nåværende tidspunkt. Format: YYYY-MM-DD HH:mm:ss+ZZ (2020-09-16 23:00:00+00) |
| `untilDate` | `String` | Arrangementer som finner sted til og med denne datoen. Standard er tom. Format: YYYY-MM-DD HH:mm:ss+ZZ (2020-09-16 23:00:00+00) |
| `fromStartDate` | `String` | Arrangementer som starter på dette tidspunktet eller senere. Standard er tom. Format: YYYY-MM-DD HH:mm:ss+ZZ (2020-09-16 23:00:00+00) |
| `mode` | `String` | Arrangementer med den oppgitte formen: online eller offline |
| `organizers` | `[String]` | Arrangementer for de oppgitte arrangør-slugene |
| `organizerSlug` | `String` | Arrangementer for den oppgitte arrangør-sluggen |
| `sortBy` | `String` | Sortering av resultatet. Mulige verdier: 'date' eller 'popularity'. Standard: 'popularity' – UTGÅTT: bare kronologisk rekkefølge støttes **Utgått:** Bare kronologisk rekkefølge støttes |
| `searchTerm` | `String` | Arrangementer for det oppgitte søkeordet. |
| `superEvent` | `String` | ID-en til det overordnede arrangementet (beholderen) (en festival, et marked osv.) |
| `venues` | `[String]` | Arrangementer på de oppgitte steds-slugene |
| `venueSlug` | `String` | Arrangementer på det oppgitte stedet (venueSlug) |
| `onlyFeatured` | `Boolean` | Sett til true hvis du bare vil ha fremhevede arrangementer. Standard: false |
| `onlyFeaturedSpecialEvent` | `Boolean` | Sett til true hvis du bare vil ha arrangementer fremhevet i et spesialarrangement. Standard: false |
| `notCategories` | `[String]` | Arrangementer uten noen av de oppgitte kategoriene. Mulige verdier: <CATEGORY_IDS: per lisens, se assets/data/categories.json> |
| `tag` | `String` | Stikkord knyttet til et arrangement |
| `cancelledNotIncluded` | `Boolean` | Sett til true hvis du ikke vil ha avlyste arrangementer. Standard: false |
| `soldOutNotIncluded` | `Boolean` | Sett til true hvis du ikke vil ha utsolgte arrangementer. Standard: false |
| `hoursRange` | `String` | Tidsrom arrangementene skal filtreres på. Standard er tom. Format: HH:mm-HH:mm (16:00-22:00) |
| `groupRepetitionsByDay` | `Boolean` | Hvis true, returneres gjentakelser som finner sted på ulike dager som egne arrangementer |
| `municipality` | `String` | Filtrer arrangementer på kommune |
| `postalCodes` | `[String]` | Filtrer arrangementer på postnumre – liste av strenger |
| `onlyFeaturedVMFest` | `Boolean` | UTGÅTT: Bruk onlyFeaturedSpecialEvent i stedet. Sett til true hvis du bare vil ha fremhevede VM Fest-arrangementer |
| `onlyVMFest` | `Boolean` | UTGÅTT: Bruk filteret superEvent i stedet. Sett til true hvis du bare vil ha VM Fest-arrangementer |

## type Image

| Felt | Type | Beskrivelse |
|---|---|---|
| `alt` | `String` |  |
| `caption` | `String` |  |
| `credits` | `String` |  |
| `urlLarge` | `String` |  |
| `urlSmall` | `String` |  |
| `urlOriginal` | `String` |  |
| `originalSize` | `Int` |  |
| `largeSize` | `Int` |  |
| `smallSize` | `Int` |  |
| `focusX` | `Float` | Hvor menneskene er i bildet, som en andel av bredden: 0 er venstre kant, 1 er høyre kant. Bruk det sammen med focusY for å beskjære rundt dem, f.eks. CSS object-position: 51% 31% på et bilde med object-fit: cover. Null når det ikke ble funnet noe ansikt eller bildet ikke er analysert ennå — behold din egen standardbeskjæring da. |
| `focusY` | `Float` | Hvor menneskene er i bildet, som en andel av høyden: 0 er øverste kant, 1 er nederste kant. Null når focusX er null. |
| `width` | `Int` | Bildets bredde i piksler på urlLarge. Null til bildet er analysert. |
| `height` | `Int` | Bildets høyde i piksler på urlLarge. Null til bildet er analysert. |

## type Location

| Felt | Type | Beskrivelse |
|---|---|---|
| `latitude` | `Float` |  |
| `longitude` | `Float` |  |

## type Organizer

| Felt | Type | Beskrivelse |
|---|---|---|
| `id` | `ID` |  |
| `email` | `String` |  |
| `name` | `String` |  |
| `slug` | `String` |  |
| `telephoneNumber` | `String` |  |
| `website` | `String` |  |

## type OrganizersInfo

| Felt | Type | Beskrivelse |
|---|---|---|
| `organizer` | `Organizer` |  |
| `hits` | `Int` |  |

## type PageInfo

| Felt | Type | Beskrivelse |
|---|---|---|
| `currentPage` | `Int` |  |
| `pageSize` | `Int` |  |
| `totalPages` | `Int` |  |

## type Price

| Felt | Type | Beskrivelse |
|---|---|---|
| `type` | `String` |  |
| `price` | `Int` |  |
| `name_nb` | `String` |  |
| `name_en` | `String` |  |

## type Repetition

| Felt | Type | Beskrivelse |
|---|---|---|
| `id` | `ID` |  |
| `activeTickets` | `Int` |  |
| `availableTickets` | `Int` |  |
| `startDate` | `String` | Startdato og -tid for denne forekomsten. Samme format og tidssoneregler som Event.startDate. |
| `endDate` | `String` | Sluttdato og -tid for denne forekomsten. Samme format og tidssoneregler som Event.startDate. |
| `startTime` | `String` | Starttid på veggklokka for denne forekomsten i norsk lokal tid, upåvirket av sommertid. Eksempel: 14:00 |
| `duration` | `Int` | Varigheten av denne forekomsten i minutter |
| `eventCancelled` | `Boolean` |  |
| `eventSoldOut` | `Boolean` |  |
| `mode` | `String` |  |
| `ticketsURL` | `String` |  |
| `streamingURL` | `String` |  |
| `venue` | `Venue` | Arrangementets sted. Kan være null hvis arrangementet er på nett |
| `prices` | `[Price]` | Priser for akkurat denne gjentakelsen. Hvis null, bruk arrangementets priser |

## type TranslationMeta

| Felt | Type | Beskrivelse |
|---|---|---|
| `title_nb` | `Boolean` | Angir om den norske tittelen er maskinoversatt |
| `title_en` | `Boolean` | Angir om den engelske tittelen er maskinoversatt |
| `desc_nb` | `Boolean` | Angir om den norske beskrivelsen er maskinoversatt |
| `desc_en` | `Boolean` | Angir om den engelske beskrivelsen er maskinoversatt |

## type Venue

| Felt | Type | Beskrivelse |
|---|---|---|
| `address` | `String` |  |
| `id` | `ID` |  |
| `location` | `Location` |  |
| `mapImageURL` | `String` |  |
| `municipality` | `String` | UTGÅTT: Kommuneinformasjon. Returnerer tom streng for bakoverkompatibilitet. |
| `name` | `String` |  |
| `slug` | `String` |  |

## type VenuesInfo

| Felt | Type | Beskrivelse |
|---|---|---|
| `venue` | `Venue` |  |
| `hits` | `Int` |  |