Skip to content
Uranus Docs
Esc
↑↓navigate↵open⌘Jpreview

Get choosable link types

Returns the link types that can be selected for an organization, venue, event or other entity.

The returned names are localized according to the requested ISO 639-1 language code.

GET/api/choosable-link-types
Query parameters
langstring

ISO 639-1 language code used for the localized link type names. Defaults to English.

min length 2 · max length 2 · default: "en"
Responses
200

Link types found.

servicestringrequired
api_versionstringrequired
response_typestringrequired
statusintegerrequired

HTTP status code of the response.

Allowed:200
timestampstring<date-time>required
metadataGetChoosableLinkTypes.ChoosableLinkTypesMetadata
Show properties
languagestring

ISO 639-1 language code used for localization.

link_type_countinteger

Number of returned link types.

min 0
response_time_msinteger

Server-side response time in milliseconds.

min 0
dataGetChoosableLinkTypes.LinkType[]required

Response payload.

Show properties
Array of GetChoosableLinkTypes.LinkType
keystring | anyrequired

Internal identifier of the link type.

Show properties
Any of:
string
string
any
any
namestring | anyrequired

Localized display name of the link type.

Show properties
Any of:
string
string
any
any
messagestring
404

No link types were found for the requested language.

servicestringrequired
api_versionstringrequired
response_typestringrequired
statusintegerrequired

HTTP status code of the response.

Allowed:404
timestampstring<date-time>required
metadataGetChoosableLinkTypes.ChoosableLinkTypesMetadata
Show properties
languagestring

ISO 639-1 language code used for localization.

link_type_countinteger

Number of returned link types.

min 0
response_time_msinteger

Server-side response time in milliseconds.

min 0
dataany

Response payload.

Show properties
Any of:
any
any
any
any
messagestring
500

Internal server error.

servicestringrequired
api_versionstringrequired
response_typestringrequired
statusintegerrequired

HTTP status code of the response.

Allowed:500
timestampstring<date-time>required
metadataGetChoosableLinkTypes.ChoosableLinkTypesMetadata
Show properties
languagestring

ISO 639-1 language code used for localization.

link_type_countinteger

Number of returned link types.

min 0
response_time_msinteger

Server-side response time in milliseconds.

min 0
dataany

Response payload.

Show properties
Any of:
any
any
any
any
messagestring
Try it
Server
Parameters
Request
curl -X GET "https://api.kulturbytes.de/api/choosable-link-types"
Response
{
  "service": "Uranus API",
  "api_version": "1.0",
  "response_type": "get-choosable-link-types",
  "status": 200,
  "timestamp": "2026-09-20T08:07:43Z",
  "metadata": {
    "language": "en",
    "link_type_count": 15,
    "response_time_ms": 3
  },
  "data": [
    {
      "key": "bandcamp",
      "name": "Bandcamp"
    },
    {
      "key": "facebook",
      "name": "Facebook"
    },
    {
      "key": "instagram",
      "name": "Instagram"
    },
    {
      "key": "artist_website",
      "name": "Kunstnerens website"
    },
    {
      "key": "mastodon",
      "name": "Mastodon"
    },
    {
      "key": "source_website",
      "name": "Mere info hos arrangøren"
    },
    {
      "key": "other",
      "name": "Other"
    },
    {
      "key": "pdf",
      "name": "PDF"
    },
    {
      "key": "soundcloud",
      "name": "SoundCloud"
    },
    {
      "key": "spotify",
      "name": "Spotify"
    },
    {
      "key": "tickets",
      "name": "Tickets"
    },
    {
      "key": "vimeo",
      "name": "Vimeo"
    },
    {
      "key": "website",
      "name": "Website"
    },
    {
      "key": "x",
      "name": "X"
    },
    {
      "key": "youtube",
      "name": "YouTube"
    }
  ],
  "message": "Link types found"
}