> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one provider



## OpenAPI

````yaml /api/rs/openapi.json get /rs/providers/v1/{id}
openapi: 3.0.3
info:
  title: KARE API
  description: Backend API for the KARE platform
  version: dev
servers:
  - url: http://localhost:3000
    description: Local dev
security: []
tags:
  - name: better-auth
    description: >-
      Better Auth's own endpoints (sign-in, session, MFA, password) - generated
      from the audience's live config via `generateOpenAPISchema()`, not
      hand-written.
paths:
  /rs/providers/v1/{id}:
    get:
      tags:
        - providers
      summary: Get one provider
      operationId: getProviderRSV1
      parameters:
        - schema:
            type: array
            items:
              type: string
              enum:
                - contacts
                - sites
                - technicalInstallations
                - labels
                - actions-info
              description: >-
                Extend options (JSON-encoded array, e.g.
                `?extend=["category"]`):

                - "contacts": Include the linked contacts (id, name, email,
                phones, comment, notifiedAt, actions).

                - "sites": Include the linked sites (id, ref, name).

                - "technicalInstallations": Include the linked technical
                installations (id, ref, name).

                - "labels": Include the linked labels (id, name, color).

                - "actions-info": Adds `actions` { canBeArchived,
                canBeUnarchived }.
          in: query
          name: extend
          required: false
        - schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  ref:
                    type: string
                    maxLength: 40
                    pattern: ^[A-Z]+-[1-9]\d*(?:-[A-Z]+-[1-9]\d*)*$
                  name:
                    type: string
                    minLength: 1
                    maxLength: 150
                  types:
                    type: array
                    items:
                      type: string
                      enum:
                        - qualified_technician
                        - approved_organization
                        - training_provider
                  comment:
                    nullable: true
                    type: string
                    maxLength: 1000
                  location:
                    nullable: true
                    type: string
                    maxLength: 300
                  country:
                    nullable: true
                    type: string
                    maxLength: 100
                  primaryContactId:
                    nullable: true
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  organizationId:
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
                  archivedAt:
                    nullable: true
                    type: string
                    format: date-time
                  contacts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        name:
                          type: string
                          minLength: 1
                          maxLength: 150
                        email:
                          nullable: true
                          type: string
                          format: email
                          pattern: >-
                            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                        phones:
                          maxItems: 5
                          type: array
                          items:
                            type: string
                            minLength: 1
                            maxLength: 30
                        comment:
                          nullable: true
                          type: string
                          maxLength: 1000
                        notifiedAt:
                          nullable: true
                          type: string
                          format: date-time
                        actions:
                          type: object
                          properties:
                            canBeUpdated:
                              type: boolean
                            canBeDeleted:
                              type: boolean
                          required:
                            - canBeUpdated
                            - canBeDeleted
                          additionalProperties: false
                      required:
                        - id
                        - name
                        - email
                        - phones
                        - comment
                        - notifiedAt
                        - actions
                      additionalProperties: false
                  sites:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        ref:
                          type: string
                          maxLength: 40
                          pattern: ^[A-Z]+-[1-9]\d*(?:-[A-Z]+-[1-9]\d*)*$
                        name:
                          type: string
                          minLength: 1
                          maxLength: 150
                      required:
                        - id
                        - ref
                        - name
                      additionalProperties: false
                  technicalInstallations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        ref:
                          type: string
                          maxLength: 40
                          pattern: ^[A-Z]+-[1-9]\d*(?:-[A-Z]+-[1-9]\d*)*$
                        name:
                          type: string
                          minLength: 1
                          maxLength: 150
                      required:
                        - id
                        - ref
                        - name
                      additionalProperties: false
                  labels:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        name:
                          type: string
                          minLength: 1
                          maxLength: 100
                        color:
                          type: string
                          pattern: ^#[0-9a-fA-F]{6}$
                      required:
                        - id
                        - name
                        - color
                      additionalProperties: false
                  actions:
                    type: object
                    properties:
                      canBeArchived:
                        type: boolean
                      canBeUnarchived:
                        type: boolean
                    required:
                      - canBeArchived
                      - canBeUnarchived
                    additionalProperties: false
                required:
                  - id
                  - ref
                  - name
                  - types
                  - comment
                  - location
                  - country
                  - primaryContactId
                  - organizationId
                  - createdAt
                  - updatedAt
                  - archivedAt
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false

````