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

# Listar cursos da empresa

> Use IDs da árvore retornada por getMemberCourse; o curso e seus recursos pertencem exclusivamente à empresa do token. Descubra courseId, productId e IDs aninhados; page/pageSize, filtro productId e total incluem rascunhos e publicados.



## OpenAPI

````yaml /openapi.yaml get /v1/member-courses
openapi: 3.0.3
info:
  title: Ephra API
  description: >-
    API pública da Ephra: cobranças (PIX, cartão e boleto), transações, webhooks
    e a API do vendedor sobre catálogo, checkout, vendas, reembolsos,
    financeiro, crescimento e plataforma.


    **Limite de requisições.** 1000 requisições por minuto por IP de origem.
    Toda resposta traz `x-ratelimit-limit`, `x-ratelimit-remaining` e
    `x-ratelimit-reset` (segundos até a janela zerar); ao estourar o limite a
    resposta é `429` com `retry-after`.


    **Um `429` que não é limite de requisições.** Em `POST /v1/card` e `POST
    /v1/subscriptions`, um `429` com `code: "BUYER_ATTEMPTS_EXCEEDED"` no corpo
    significa que este comprador, e só ele, está bloqueado para pagar com cartão
    depois de tentativas recusadas em excesso. Nada foi cobrado. Não pause nem
    atrase as cobranças de outros compradores por causa dele, e não repita a
    cobrança deste comprador antes de `blockedUntil` (ISO 8601 UTC, também em
    `retryAfterSeconds` e no header `retry-after`; os dois campos vêm `null`
    quando o horário não é conhecido). Pix continua disponível para o mesmo
    comprador. Diferencie os dois casos sempre pelo `code`, nunca pelo status.


    **Erros.** Toda falha responde o mesmo envelope: `{ "success": false,
    "message": "..." }`.
  version: 1.0.0
servers:
  - url: https://api.ephra.io
    description: Servidor de produção
security: []
tags:
  - name: Catálogo
    description: Produtos, ofertas, categorias e cupons — o que a empresa vende.
  - name: Checkout
    description: Checkouts, order bumps, upsells e links de pagamento.
  - name: Vendas
    description: Vendas, clientes, assinaturas e entregas já realizadas.
  - name: Reembolsos
    description: Pedidos de reembolso, contestações e o quiz de retenção.
  - name: Financeiro
    description: Saldo, saques, antecipações, taxas e extratos da empresa.
  - name: Crescimento
    description: Afiliados, coprodução, indicações, pixels e integrações de marketing.
  - name: Plataforma
    description: Conta, membros, chaves de API, webhooks e configurações gerais.
paths:
  /v1/member-courses:
    get:
      tags:
        - Catálogo
      summary: Listar cursos da empresa
      description: >-
        Use IDs da árvore retornada por getMemberCourse; o curso e seus recursos
        pertencem exclusivamente à empresa do token. Descubra courseId,
        productId e IDs aninhados; page/pageSize, filtro productId e total
        incluem rascunhos e publicados.
      operationId: listMemberCourses
      parameters:
        - schema:
            type: integer
            minimum: 1
            default: 1
          in: query
          name: page
          required: false
          description: Página desejada, começando em 1.
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          in: query
          name: pageSize
          required: false
          description: Quantidade de itens por página (máximo 100).
        - schema:
            type: string
            minLength: 1
            maxLength: 128
          in: query
          name: productId
          required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `true` em uma resposta bem-sucedida.
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        cover:
                          type: object
                          properties:
                            url:
                              type: string
                              format: uri
                            alt:
                              type: string
                              maxLength: 500
                              nullable: true
                            expiresAt:
                              type: string
                              format: date-time
                              nullable: true
                          required:
                            - url
                            - alt
                            - expiresAt
                          additionalProperties: false
                          nullable: true
                        id:
                          type: string
                        slug:
                          type: string
                        kind:
                          type: string
                          enum:
                            - course
                            - bonus
                        status:
                          type: string
                          enum:
                            - draft
                            - published
                        title:
                          type: string
                        producerName:
                          type: string
                        tagline:
                          type: string
                        description:
                          type: string
                        category:
                          type: string
                        level:
                          type: string
                        highlights:
                          type: array
                          items:
                            type: string
                        certificateHours:
                          type: integer
                          minimum: 0
                        productId:
                          type: string
                        instructor:
                          type: object
                          properties:
                            name:
                              type: string
                            role:
                              type: string
                            bio:
                              type: string
                            initials:
                              type: string
                          required:
                            - name
                            - role
                            - bio
                            - initials
                          additionalProperties: false
                        artwork:
                          type: object
                          properties:
                            from:
                              type: string
                            via:
                              type: string
                            to:
                              type: string
                            glow:
                              type: string
                            motif:
                              type: string
                              enum:
                                - bars
                                - circle
                                - grid
                                - spark
                                - waves
                          required:
                            - from
                            - via
                            - to
                            - glow
                            - motif
                          additionalProperties: false
                        enrolledAt:
                          type: string
                          format: date-time
                          nullable: true
                        modules:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              title:
                                type: string
                              lessons:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    slug:
                                      type: string
                                    title:
                                      type: string
                                    summary:
                                      type: string
                                    kind:
                                      type: string
                                      enum:
                                        - video
                                        - reading
                                    durationSeconds:
                                      type: integer
                                      minimum: 0
                                    releaseAfterDays:
                                      type: integer
                                      minimum: 0
                                      nullable: true
                                    released:
                                      type: boolean
                                    body:
                                      type: array
                                      items:
                                        type: string
                                    image:
                                      type: object
                                      properties:
                                        url:
                                          type: string
                                          format: uri
                                        alt:
                                          type: string
                                          maxLength: 500
                                          nullable: true
                                        expiresAt:
                                          type: string
                                          format: date-time
                                          nullable: true
                                      required:
                                        - url
                                        - alt
                                        - expiresAt
                                      additionalProperties: false
                                      nullable: true
                                    youtubeVideoId:
                                      type: string
                                      nullable: true
                                    embedUrl:
                                      type: string
                                      format: uri
                                      nullable: true
                                    materials:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          id:
                                            type: string
                                          title:
                                            type: string
                                          kind:
                                            type: string
                                            enum:
                                              - link
                                              - pdf
                                              - sheet
                                          url:
                                            type: string
                                            format: uri
                                          sizeLabel:
                                            type: string
                                            nullable: true
                                        required:
                                          - id
                                          - title
                                          - kind
                                          - url
                                          - sizeLabel
                                        additionalProperties: false
                                    comments:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          id:
                                            type: string
                                          authorName:
                                            type: string
                                          body:
                                            type: string
                                          isInstructor:
                                            type: boolean
                                          postedAt:
                                            type: string
                                            format: date-time
                                          ownedByViewer:
                                            type: boolean
                                        required:
                                          - id
                                          - authorName
                                          - body
                                          - isInstructor
                                          - postedAt
                                          - ownedByViewer
                                        additionalProperties: false
                                  required:
                                    - id
                                    - slug
                                    - title
                                    - summary
                                    - kind
                                    - durationSeconds
                                    - releaseAfterDays
                                    - released
                                    - body
                                    - image
                                    - youtubeVideoId
                                    - embedUrl
                                    - materials
                                    - comments
                                  additionalProperties: false
                            required:
                              - id
                              - title
                              - lessons
                            additionalProperties: false
                      required:
                        - cover
                        - id
                        - slug
                        - kind
                        - status
                        - title
                        - producerName
                        - tagline
                        - description
                        - category
                        - level
                        - highlights
                        - certificateHours
                        - productId
                        - instructor
                        - artwork
                        - enrolledAt
                        - modules
                      additionalProperties: false
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                        description: Página devolvida.
                      pageSize:
                        type: integer
                        description: Itens por página pedidos.
                      total:
                        type: integer
                        description: Total de itens que satisfazem o filtro.
                      totalPages:
                        type: integer
                        description: Total de páginas disponíveis.
                    required:
                      - page
                      - pageSize
                      - total
                      - totalPages
                    additionalProperties: false
                required:
                  - success
                  - data
                  - pagination
                additionalProperties: false
              example:
                success: true
                data: []
                pagination:
                  page: 1
                  pageSize: 10
                  total: 0
                  totalPages: 0
        '400':
          description: A requisição está bem formada, mas uma regra de negócio a recusou.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  A requisição está bem formada, mas uma regra de negócio a
                  recusou.
              example:
                success: false
                message: >-
                  Não foi possível concluir: uma regra de negócio recusou os
                  dados enviados.
        '401':
          description: Token ausente, inválido, expirado ou de empresa bloqueada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: Token ausente, inválido, expirado ou de empresa bloqueada.
              example:
                success: false
                message: Token inválido ou expirado
        '404':
          description: O recurso não existe, foi excluído ou pertence a outra empresa.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  O recurso não existe, foi excluído ou pertence a outra
                  empresa.
              example:
                success: false
                message: Recurso não encontrado
        '409':
          description: O recurso não aceita esta operação no estado em que se encontra.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  O recurso não aceita esta operação no estado em que se
                  encontra.
              example:
                success: false
                message: >-
                  O recurso não aceita esta operação no estado em que se
                  encontra.
        '422':
          description: A requisição não passou na validação de schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: A requisição não passou na validação de schema.
              example:
                success: false
                message: 'name: Nome é obrigatório'
        '429':
          description: >-
            Requisições demais: o limite é de 1000 requisições por minuto por IP
            de origem. Espere o número de segundos do header `retry-after` e
            repita com recuo exponencial.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Requisições demais: o limite é de 1000 requisições por minuto
                  por IP de origem. Espere o número de segundos do header
                  `retry-after` e repita com recuo exponencial.
              example:
                success: false
                message: Muitas requisições. Tente novamente em breve.
          headers:
            retry-after:
              $ref: '#/components/headers/retry-after'
            x-ratelimit-limit:
              $ref: '#/components/headers/x-ratelimit-limit'
            x-ratelimit-remaining:
              $ref: '#/components/headers/x-ratelimit-remaining'
            x-ratelimit-reset:
              $ref: '#/components/headers/x-ratelimit-reset'
        '500':
          description: >-
            Falha interna ao processar a requisição. Repita; se persistir, abra
            chamado com o horário e a rota.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Falha interna ao processar a requisição. Repita; se persistir,
                  abra chamado com o horário e a rota.
              example:
                success: false
                message: Erro interno do servidor
      security:
        - bearerAuth: []
components:
  headers:
    retry-after:
      description: Segundos a esperar antes de repetir a requisição.
      schema:
        type: integer
    x-ratelimit-limit:
      description: Teto de requisições na janela (1000). Presente em toda resposta.
      schema:
        type: integer
    x-ratelimit-remaining:
      description: >-
        Quantas requisições ainda cabem na janela atual. Presente em toda
        resposta.
      schema:
        type: integer
    x-ratelimit-reset:
      description: Segundos até o contador da janela zerar. Presente em toda resposta.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.