Join the Student Life Contact API

openapi: 3.2.0
info:
  title: Student Life Contact API
  version: 1.0.0
  summary: Student cities, events, ticket prices and partner deals.
  description: 'Open, keyless JSON API of The Student Life (jointhestudentlife.com): the cities where we run student communities, their guides, upcoming events with ticket prices and status, partner deals and pricing. Read endpoints need no authentication. Data refreshes whenever the website does. For AI agents, the same data is available as an MCP server at https://jointhestudentlife.com/mcp. Versioning and deprecation policy: the version is in the path (/api/v1); inside v1 we aim to only add things; a breaking change ships as /api/v2 and is announced on https://jointhestudentlife.com/developers#versioning before the old version changes, with Deprecation (RFC 9745) and, once a date is set, Sunset (RFC 8594) headers on affected endpoints. Rate limits are best effort per client, reported in RateLimit and X-RateLimit headers. Pagination is cursor based. Sandbox: POST /api/contact accepts dry_run to validate without sending.'
  contact:
    name: The Student Life
    email: support@jointhestudentlife.com
    url: https://jointhestudentlife.com/developers
  x-deprecation-policy: https://jointhestudentlife.com/developers#versioning
servers:
- url: https://jointhestudentlife.com
security: []
tags:
- name: Contact
  description: Messages to the team
paths:
  /api/contact:
    post:
      operationId: sendMessage
      summary: Send a message to the team
      description: 'The endpoint behind the website forms. Emails support@jointhestudentlife.com with reply to set to the sender. Only send with the person''s consent and their own details. Meant for server side callers: browser pages on other sites get 403. About 20 messages per minute per client.'
      tags:
      - Contact
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - email
              - message
              properties:
                name:
                  type: string
                  maxLength: 120
                email:
                  type: string
                  format: email
                  maxLength: 200
                message:
                  type: string
                  maxLength: 6000
                subject:
                  type: string
                  maxLength: 160
                city:
                  type: string
                form_type:
                  type: string
                  description: Which form this is, e.g. agent-question.
                dry_run:
                  type: boolean
                  description: 'Sandbox: validate the message and stop before anything is sent.'
      responses:
        '200':
          description: Accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  dry_run:
                    type: boolean
          headers:
            Idempotency-Key:
              $ref: '#/components/headers/Idempotency-Key'
            Idempotent-Replayed:
              $ref: '#/components/headers/Idempotent-Replayed'
        '400':
          description: Missing or invalid fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '405':
          description: Only POST
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '502':
          description: Could not send
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '503':
          description: Not configured
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '403':
          description: A browser page on another site (forbidden_origin)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '409':
          description: A request with this Idempotency-Key is still being processed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '422':
          description: Idempotency-Key reused with a different body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
        '429':
          description: Rate limited
          headers:
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactError'
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        description: 'A fresh unique string per message, for example a UUID. If a retry with the same key and the same body arrives after the first message was sent, the answer is 200 with Idempotent-Replayed: true and nothing is sent again; the same key with a different body gets 422. Best effort: kept 24 hours in server memory, only successful sends are remembered.'
        schema:
          type: string
          maxLength: 200
components:
  headers:
    Retry-After:
      description: Seconds to wait after a 429.
      schema:
        type: integer
    Idempotent-Replayed:
      description: true when the response is the stored answer to an earlier request with the same Idempotency-Key.
      schema:
        type: string
    Idempotency-Key:
      description: Echo of the Idempotency-Key request header.
      schema:
        type: string
  schemas:
    ContactError:
      type: object
      properties:
        success:
          type: boolean
          const: false
        code:
          type: string
externalDocs:
  description: For AI agents and developers
  url: https://jointhestudentlife.com/developers