> ## Documentation Index
> Fetch the complete documentation index at: https://sendcloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve carrier support contacts

> A carrier support contact is required in order to create tickets for shipments sent under your own carrier contract so that we can forward the claim correctly.

Ticket creation will fail if a carrier support contact is missing for a carrier you use with your own contract.



## OpenAPI

````yaml /.openapi/v3/support/openapi.yaml get /dsf/carrier-support-contacts
openapi: 3.1.0
info:
  title: Support API [BETA]
  version: 3.0.0
  contact:
    name: Sendcloud API Support
    url: https://www.sendcloud.dev
    email: contact@sendcloud.com
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  description: >-
    The Sendcloud Support API lets you create support tickets easily and
    efficiently. This API can be used in conjunction with other core Sendcloud
    features or independently.
servers:
  - url: https://panel.sendcloud.sc/api/v3
    description: Sendcloud Production
security: []
tags:
  - name: Support
    description: Sendcloud's Support API
  - name: File upload
  - name: Carrier support contacts
  - name: Create ticket
  - name: Documents
  - name: Requested data
paths:
  /dsf/carrier-support-contacts:
    get:
      tags:
        - Carrier support contacts
      summary: Retrieve carrier support contacts
      description: >-
        A carrier support contact is required in order to create tickets for
        shipments sent under your own carrier contract so that we can forward
        the claim correctly.


        Ticket creation will fail if a carrier support contact is missing for a
        carrier you use with your own contract.
      operationId: sc-public-v3-dsf-get-carrier_support_contacts
      responses:
        '200':
          $ref: '#/components/responses/SupportContactResponse'
        '429':
          $ref: '#/components/responses/RateLimitExceededResponse'
      security:
        - HTTPBasicAuth: []
        - OAuth2ClientCreds: []
components:
  responses:
    SupportContactResponse:
      description: Create carrier support contact
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CarrierSupportContact'
          example:
            id: 1
            carrier_code: dpd
            email: dpd@email.com
            language: nl-nl
    RateLimitExceededResponse:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorsResponseSchema'
          example:
            errors:
              - code: hit_rate_limit
                detail: 'Rate limit exceeded: 30 per 1 minute'
                title: Rate limit exceeded
                status: 429
  schemas:
    CarrierSupportContact:
      title: Carrier support contact
      type: object
      properties:
        id:
          type: integer
          format: int64
          title: Carrier support contact id
        carrier_code:
          $ref: '#/components/schemas/CarrierCodeField'
        email:
          $ref: '#/components/schemas/CarrierEmailField'
        language:
          $ref: '#/components/schemas/CarrierLanguageField'
      required:
        - id
        - carrier_code
        - email
    ErrorsResponseSchema:
      description: Support API error response.
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                title: Error code
                type: string
              detail:
                title: Error description
                type: string
              title:
                title: Error title
                type: string
              status:
                title: HTTP status code
                type: integer
      required:
        - errors
    CarrierCodeField:
      description: A carrier represented by a Sendcloud code
      type: string
      enum:
        - amazon
        - bpost
        - bol
        - bring
        - brt
        - budbee
        - cainiao
        - chronopost
        - colisprive
        - colissimo
        - colissimo_ec2c
        - correos
        - correos_express
        - cirro
        - dachser
        - dbschenker
        - delivengo
        - der_kurier
        - dp
        - dhl
        - dhl_de
        - dhl_ecommerce
        - dhl_freight
        - dhl_gb
        - dhl_parcel_gb
        - dhl_parcel_iberia
        - dhl_express
        - dpd
        - dpd_at
        - dpd_fr
        - dpd_gb
        - dpd_local
        - fadello
        - fairsenden
        - fedex
        - fedexcrossborder
        - fietskoeriers
        - geodis
        - gls_de
        - gls_es
        - gls_eu
        - gls_it
        - gls_nl
        - glovo
        - hermes_c2c_gb
        - hermes_at
        - hermes_de
        - hermes_gb
        - hived
        - homerr
        - hurby
        - inpost_gb
        - inpost_es
        - inpost_it
        - inpost_pl
        - jongstra
        - landmark
        - lettresuivie
        - mondial_relay
        - mhi
        - nacex
        - ontime
        - paack
        - packs
        - parcelforce
        - mrw
        - plx
        - postat
        - poste_italiane
        - poste_it_delivery
        - postnl
        - postnl_fulfilment
        - postnl_large
        - postnord
        - quicargo
        - relais_colis
        - rjpv2
        - rjp
        - royal_mail
        - royal_mailv2
        - sandd
        - sendcloud
        - seur
        - skymail
        - storeshippers
        - tipsa
        - transmission
        - trunkrs
        - ups
        - van_straaten
        - viatim
        - ctt_express
        - tnt_it
        - yodel
        - europaket
        - spring
        - evri_international
        - asendia
        - transforce
        - dhl_2_man_handling
      example: postnl
    CarrierEmailField:
      description: >-
        Email address of the carrier to which the ticket details will be
        forwarded.
      type: string
      format: email
      example: carrier@email.com
    CarrierLanguageField:
      description: Language in which the carrier will be contacted.
      type: string
      enum:
        - de-de
        - en-gb
        - en-us
        - es-es
        - fr-fr
        - nl-nl
        - it-it
      example: en-us
  securitySchemes:
    HTTPBasicAuth:
      type: http
      description: >-
        Basic Authentication using API key and secrets is currently the main
        authentication mechanism.
      scheme: basic
    OAuth2ClientCreds:
      type: oauth2
      description: >-
        OAuth2 is a standardized protocol for authorization that allows users to
        share their private resources stored on one site with another site
        without having to provide their credentials. OAuth2 Client Credentials
        Grant workflow. This workflow is typically used for server-to-server
        interactions that require authorization to access specific resources.
      flows:
        clientCredentials:
          tokenUrl: https://account.sendcloud.com/oauth2/token/
          scopes:
            api: Default OAuth scope required to access Sendcloud API.

````