GetMattered

GetMattered Referrals API

The referrals API from GetMattered — 3 operation(s) for referrals.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /creator-links/{code} Open a creator signup link #
POST /creator-links/claim Claim creator signup attribution #
GET /referrals/stats Get my referral program stats · Get Referral Stats #
Ask an LLM
“How many people signed up through my referral link?”
“How many tokens have I earned from referrals?”
Tell an agent
Show my referral stats.
Get my referral clicks and signups.
POST /referrals/track Record a click on a referral link · Track Referral Click #
Ask an LLM
“What gets recorded when someone opens a referral link?”
“How is a referral link visit tracked?”
Tell an agent
Track a referral click for code {referralCode}.
Log a visit on referral link {referralCode}.
POST /referrals/convert Credit a signup to a referral · Convert Referral #
Ask an LLM
“How does a new signup get linked to the person who referred them?”
“Can a referral be converted after the referred user signs up?”
Tell an agent
Convert referral {referralCode} for my new account.
Link my signup to referral code {referralCode}.

Documentation

📖
APIReference
https://api.getmattered.com/api/v1/scalar

Specifications

⚙
OpenAPI
https://artifacts.apis.io/getmattered/openapi/getmattered-referrals-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-patch-user-preferences-schema.json
📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-upsert-application-profile-schema.json
📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-auto-setup-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-update-preferences-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/getmattered:getmattered-referrals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

getmattered-referrals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: support@getmattered.com
    name: GetMattered
    url: https://getmattered.com
  description: 'The GetMattered API runs the whole job hunt for you: it matches you to roles that fit your profile, rewrites your resume for each posting, writes the cover letter the form asks for, and auto-applies across the major applicant tracking systems. Every send is tracked from the swipe to the employer''s own confirmation, so you always know what landed. Authenticate with a Bearer session token. The same surface powers the web app, the mobile app and the GetMattered MCP server for ChatGPT, Claude and other agents.'
  license:
    name: Proprietary
    url: https://getmattered.com/legal/terms
  title: GetMattered Referrals API
  version: e1c6af0f
servers:
- description: Current environment
  url: https://api.getmattered.com/api/v1
security:
- BearerAuth: []
tags:
- description: Referral links, clicks and conversions.
  name: Referrals
paths:
  /creator-links/{code}:
    get:
      description: Retain the identifier of an eligible creator click in a browser cookie and redirect to sign-in. Only approved active agreements qualify. HEAD requests do not create clicks.
      summary: Open a creator signup link
      tags:
      - Referrals
      parameters:
      - schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{2,63}$
          description: Creator signup code, normalized to lowercase after trimming whitespace. Use 3 to 64 letters, digits, or hyphens, starting with a letter or digit.
        required: true
        description: Creator signup code, normalized to lowercase after trimming whitespace. Use 3 to 64 letters, digits, or hyphens, starting with a letter or digit.
        name: code
        in: path
      responses:
        '307':
          description: Continue to normal sign-in. Only an approved active link records a click.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
      operationId: getCreatorLinksByCode
  /creator-links/claim:
    post:
      description: Claim a retained creator click for the signed-in account. New claims require verified email, completed onboarding, and account creation after the click. Return whether attribution was retained. No reward or payment is issued.
      summary: Claim creator signup attribution
      tags:
      - Referrals
      responses:
        '200':
          description: Bind a retained click to a verified new account. No reward or payment is issued.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatorLinkClaimResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
      operationId: postCreatorLinksClaim
  /referrals/stats:
    get:
      description: Get referral program stats for the authenticated user including click count, signups, subscriptions, and tokens earned.
      summary: Get Referral Stats
      tags:
      - Referrals
      responses:
        '200':
          description: Referral stats for the authenticated user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferralStatsResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
      operationId: getReferralsStats
  /referrals/track:
    post:
      description: Track a referral link click. Called when a visitor lands on /r/{code}. Creates a referral record with status clicked.
      summary: Track Referral Click
      tags:
      - Referrals
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TrackReferralBody'
      responses:
        '200':
          description: Referral click tracked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrackReferralResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
      operationId: postReferralsTrack
  /referrals/convert:
    post:
      description: Convert a referral after signup. Called by frontend if localStorage has a referral_code. Links the new user to the referral record.
      summary: Convert Referral
      tags:
      - Referrals
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConvertReferralBody'
      responses:
        '200':
          description: Referral converted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConvertReferralResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
      operationId: postReferralsConvert
components:
  schemas:
    ReferralEarnedApplies:
      type: object
      properties:
        lifetime:
          type: integer
          minimum: 0
          description: Earned applies granted to the referrer across all converting signups
          example: 0
        lifetimeCap:
          type: integer
          minimum: 0
          description: Lifetime ceiling for earned applies
          example: 0
        perConvertingShare:
          type: integer
          minimum: 0
          description: Earned applies granted when a referred signup completes
          example: 0
        remaining:
          type: integer
          minimum: 0
          description: Earned applies available for the next application send
          example: 0
      required:
      - lifetime
      - lifetimeCap
      - perConvertingShare
      - remaining
      additionalProperties: false
    ReferralStatsPayload:
      type: object
      properties:
        earnedApplies:
          $ref: '#/components/schemas/ReferralEarnedApplies'
        pendingRewardPerReferral:
          type: integer
          minimum: 0
          description: Tokens the referrer earns per friend who subscribes (REFERRAL_REWARD_TOKENS)
          example: 0
        pendingRewards:
          type: integer
          minimum: 0
          description: Tokens the referrer will earn when their signed-up-but-not-yet-subscribed friends subscribe (signedUpCount × reward-per-referral)
          example: 0
        referralCode:
          type: string
          description: The user 7-char short referral code (used in /r/{code} links)
          example: K7M2QPX
        referredCount:
          type: integer
          minimum: 0
          description: Total referral link clicks
          example: 0
        signedUpCount:
          type: integer
          minimum: 0
          description: Users who signed up via referral but have not yet subscribed
          example: 0
        subscribedCount:
          type: integer
          minimum: 0
          description: Users who subscribed via referral
          example: 0
        totalTokensEarned:
          type: integer
          minimum: 0
          description: Total tokens earned from referrals (claimed)
          example: 0
      required:
      - earnedApplies
      - pendingRewardPerReferral
      - pendingRewards
      - referralCode
      - referredCount
      - signedUpCount
      - subscribedCount
      - totalTokensEarned
      additionalProperties: false
    ResponseMetadata:
      type: object
      properties:
        duration:
          type: number
          minimum: 0
          description: Request duration in milliseconds
          example: 150
        performance:
          type: object
          properties:
            dbQueries:
              type: integer
              minimum: 0
            totalDbTime:
              type: number
              minimum: 0
          description: Performance metrics (preview/local only)
        requestId:
          type: string
          description: Unique request identifier
          example: req_abc123
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp
          example: '2026-11-03T14:00:48.054Z'
        version:
          type: string
          description: API version
          example: v1
    ConvertReferralResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ConvertReferralPayload'
        meta:
          $ref: '#/components/schemas/ResponseMetadata'
        success:
          type: boolean
          enum:
          - true
      required:
      - data
      - success
      additionalProperties: false
      description: Successful API response
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            context:
              oneOf:
              - type: object
                properties:
                  errorType:
                    type: string
                    enum:
                    - validation
                  field:
                    type: string
                  fieldErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        expected:
                          type: string
                        field:
                          type: string
                        message:
                          type: string
                        received:
                          type: string
                      required:
                      - field
                      - message
                  schemaName:
                    type: string
                required:
                - errorType
              - type: object
                properties:
                  attemptedEmail:
                    type: string
                    format: email
                  errorType:
                    type: string
                    enum:
                    - authentication
                  failureReason:
                    type: string
                    enum:
                    - invalid_credentials
                    - account_locked
                    - expired_token
                    - token_expired
                    - missing_token
                    - invalid_token
                    - session_expired
                    description: Reason for authentication failure
                    example: token_expired
                  ipAddress:
                    type: string
                  operation:
                    type: string
                  service:
                    type: string
                  userAgent:
                    type: string
                required:
                - errorType
              - type: object
                properties:
                  actualPermission:
                    type: string
                  errorType:
                    type: string
                    enum:
                    - authorization
                  requiredPermission:
                    type: string
                  resource:
                    type: string
                  resourceId:
                    type: string
                  userId:
                    type: string
                required:
                - errorType
              - type: object
                properties:
                  constraint:
                    type: string
                  errorType:
                    type: string
                    enum:
                    - database
                  operation:
                    type: string
                    enum:
                    - insert
                    - update
                    - delete
                    - select
                    - batch
                    - transaction
                    - migration
                    description: Type of database operation
                    example: select
                  resourceId:
                    type: string
                  sqlState:
                    type: string
                  table:
                    type: string
                  userId:
                    type: string
                required:
                - errorType
              - type: object
                properties:
                  endpoint:
                    type: string
                  errorType:
                    type: string
                    enum:
                    - external_service
                  httpStatus:
                    type: number
                  operation:
                    type: string
                  resourceId:
                    type: string
                  responseTime:
                    type: number
                  retryAttempt:
                    type: integer
                  service:
                    type: string
                  serviceName:
                    type: string
                  userId:
                    type: string
                required:
                - errorType
              - type: object
                properties:
                  errorType:
                    type: string
                    enum:
                    - resource
                  resource:
                    type: string
                  resourceId:
                    type: string
                  service:
                    type: string
                  userId:
                    type: string
                required:
                - errorType
              - type: object
                properties:
                  errorType:
                    type: string
                    enum:
                    - rate_limit
                  limit:
                    type: number
                  resetTime:
                    type: string
                  windowMs:
                    type: number
                required:
                - errorType
              - type: object
                properties:
                  configKey:
                    type: string
                  errorType:
                    type: string
                    enum:
                    - configuration
                  operation:
                    type: string
                  service:
                    type: string
                required:
                - errorType
              description: Type-safe error context information
              example:
                errorType: validation
                fieldErrors:
                - field: email
                  message: Invalid email format
            details:
              oneOf:
              - type: object
                properties:
                  detailType:
                    type: string
                    enum:
                    - validation
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        field:
                          type: string
                        message:
                          type: string
                      required:
                      - field
                      - message
                required:
                - detailType
                - validationErrors
                additionalProperties: false
              - type: object
                properties:
                  detailType:
                    type: string
                    enum:
                    - service_error
                  originalError:
                    type: string
                  serviceName:
                    type: string
                required:
                - detailType
                - serviceName
                additionalProperties: false
              - type: object
                properties:
                  currentSize:
                    type: number
                  detailType:
                    type: string
                    enum:
                    - batch
                  originalError:
                    type: string
                  statementCount:
                    type: number
                required:
                - detailType
                additionalProperties: false
              - type: object
                properties:
                  detailType:
                    type: string
                    enum:
                    - rate_limit
                  limit:
                    type: number
                  resetTime:
                    type: string
                  windowMs:
                    type: number
                required:
                - detailType
                - limit
                - resetTime
                - windowMs
                additionalProperties: false
              - type: object
                properties:
                  conflictingField:
                    type: string
                  detailType:
                    type: string
                    enum:
                    - resource
                  resourceId:
                    anyOf:
                    - type: string
                    - type: number
                  resourceType:
                    type: string
                required:
                - detailType
                additionalProperties: false
              - type: object
                properties:
                  detailType:
                    type: string
                    enum:
                    - generic
                  info:
                    type: string
                required:
                - detailType
                additionalProperties: false
              - type: object
                properties:
                  currentTokens:
                    type: integer
                    minimum: 0
                  detailType:
                    type: string
                    enum:
                    - insufficient_tokens
                  requiredTokens:
                    type: integer
                    minimum: 0
                required:
                - currentTokens
                - detailType
                - requiredTokens
                additionalProperties: false
            message:
              type: string
            validation:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  field:
                    type: string
                  message:
                    type: string
                required:
                - field
                - message
                additionalProperties: false
          required:
          - code
          - message
          additionalProperties: false
        meta:
          $ref: '#/components/schemas/ResponseMetadata'
        success:
          type: boolean
          enum:
          - false
      required:
      - error
      - success
      additionalProperties: false
    TrackReferralBody:
      type: object
      properties:
        referralCode:
          type: string
          minLength: 1
          description: Referral code from the /r/{code} link (7-char short code, or a legacy raw user ID for backward compatibility)
          example: K7M2QPX
      required:
      - referralCode
      additionalProperties: false
    ReferralStatsResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ReferralStatsPayload'
        meta:
          $ref: '#/components/schemas/ResponseMetadata'
        success:
          type: boolean
          enum:
          - true
      required:
      - data
      - success
      additionalProperties: false
      description: Successful API response
    TrackReferralResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            status:
              type: string
              enum:
              - clicked
              - signed_up
              - subscribed
              description: 'Referral lifecycle status: clicked (visited link), signed_up (created account), subscribed (purchased plan)'
              example: clicked
            tracked:
              type: boolean
              description: Whether the referral click was tracked
          required:
          - status
          - tracked
          additionalProperties: false
        meta:
          $ref: '#/components/schemas/ResponseMetadata'
        success:
          type: boolean
          enum:
          - true
      required:
      - data
      - success
      additionalProperties: false
      description: Successful API response
    ConvertReferralPayload:
      type: object
      properties:
        converted:
          type: boolean
          description: Whether the referral was successfully converted
      required:
      - converted
      additionalProperties: false
    CreatorLinkClaimResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            converted:
              type: boolean
          required:
          - converted
          additionalProperties: false
        meta:
          $ref: '#/components/schemas/ResponseMetadata'
        success:
          type: boolean
          enum:
          - true
      required:
      - data
      - success
      additionalProperties: false
      description: Successful API response
    ConvertReferralBody:
      type: object
      properties:
        referralCode:
          type: string
          minLength: 1
          description: Referral code from localStorage, set during /r/{code} redirect (7-char short code, or a legacy raw user ID for backward compatibility)
          example: K7M2QPX
      required:
      - referralCode
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      description: 'Session token from signing in to GetMattered, sent as `Authorization: Bearer <token>`.'
      scheme: bearer
      type: http