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

# List partner organizations

> Retrieves a paginated list of organizations associated with a specific partner.




## OpenAPI

````yaml /openapi/findity-admin-api.json get /partners/{partnerId}/organizations
openapi: 3.1.0
info:
  title: Findity Admin API
  description: Findity Admin API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/admin
  - url: https://api.findity.com/api/v1/admin
security:
  - bearerAuth: []
paths:
  /partners/{partnerId}/organizations:
    get:
      tags:
        - Partners
      summary: List partner organizations
      description: >
        Retrieves a paginated list of organizations associated with a specific
        partner.
      operationId: listPartnerOrganizations
      parameters:
        - name: partnerId
          in: path
          required: true
          description: Partner external ID
          schema:
            type: string
            example: abc123
        - name: max
          in: query
          required: false
          description: Maximum number of results to return
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
            example: 50
        - name: offset
          in: query
          required: false
          description: Number of results to skip for pagination
          schema:
            type: integer
            minimum: 0
            default: 0
            example: 0
        - name: sort
          in: query
          required: false
          description: Field to sort by
          schema:
            type: string
            enum:
              - name
              - dateCreated
              - employees
              - price
              - payedByPartner
              - orgNumber
              - article-group-name
              - unverifiedCards
            example: name
        - name: sortOrder
          in: query
          required: false
          description: Sort order
          schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
            example: asc
        - name: q
          in: query
          required: false
          description: Search query to filter organizations by name
          schema:
            type: string
            example: Part
      responses:
        '200':
          description: Successfully retrieved partner organizations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOrganizations'
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Error'
        '404':
          description: Partner not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
components:
  schemas:
    PartnerOrganizations:
      type: object
      description: >-
        Partner organizations response containing both template and member
        organizations
      properties:
        id:
          type: string
          description: Partner external ID
          example: abc123
        name:
          type: string
          description: Partner name
          example: Partner
        partnerCode:
          type: string
          description: Partner code
          example: P123
        groupInvoiceArticles:
          type: boolean
          description: Whether to group invoice articles
          example: true
        articleGroupName:
          type: string
          nullable: true
          description: Name of the article group
          example: Article group name
        newOrganizationsPayedByOrg:
          type: boolean
          nullable: true
          description: >-
            Flag indicating whether new organizations created under this partner
            will be paid by an existing organization
          example: false
        total:
          type: integer
          description: Total number of organizations available
          example: 25
        count:
          type: integer
          description: Number of organizations returned in this response
          example: 10
        templateOrganizations:
          type: array
          description: List of template organizations
          items:
            $ref: '#/components/schemas/PartnerTemplateOrganization'
        memberOrganizations:
          type: array
          description: List of member organizations
          items:
            $ref: '#/components/schemas/PartnerMemberOrganization'
    400Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
      example:
        result: error
        code: ORGANIZATION_NOT_FOUND
        description: 'Failed to get organization for id: {orgId}'
    PartnerTemplateOrganization:
      type: object
      description: Template organization with recipients/consultants information
      properties:
        id:
          type: string
          description: Organization ID
          example: tempid123
        name:
          type: string
          description: Organization name
          example: Template Organization
        externalSourceId:
          type: string
          nullable: true
          description: External source identifier
          example: EXT001
        dateCreated:
          type: string
          format: date-time
          description: Date when organization was created
        accountingSettingsCountryCode:
          type: string
          nullable: true
          description: Country code for accounting settings
          example: SE
        categoryGroups:
          type: array
          description: List of category groups
          items:
            type: string
          example:
            - com.findity.economy.accounting.RepresentationExpenseCategory
        recipients:
          type: array
          description: List of recipients for this template organization
          items:
            $ref: '#/components/schemas/RecipientInfo'
    PartnerMemberOrganization:
      type: object
      description: Member organization
      properties:
        id:
          type: string
          description: Organization ID
          example: memberorg123
        name:
          type: string
          description: Organization name
          example: Member Organization
        externalSourceId:
          type: string
          nullable: true
          description: External source identifier
          example: EXT002
        vat:
          type: string
          nullable: true
          description: VAT number
          example: SE123456789001
        dateCreated:
          type: string
          format: date-time
          description: Date when organization was created
        employees:
          type: integer
          nullable: true
          description: Number of employees
          example: 50
        hasOwnLicensePrice:
          type: boolean
          description: Whether organization has its own license price
          example: true
        licensePrice:
          type: number
          nullable: true
          description: License price if hasOwnLicensePrice is true
          example: 25.5
        payedByPartner:
          type: boolean
          nullable: true
          description: Whether organization is paid by partner
          example: false
        label:
          type: string
          nullable: true
          description: Organization label
          example: label
        unverifiedCards:
          type: integer
          nullable: true
          description: Number of unverified cards
          example: 3
        paymentSettings:
          type: object
          nullable: true
          description: Payment settings for the organization
          properties:
            id:
              type: string
              example: payment
            product:
              type: string
              example: product
            priceFixed:
              type: number
              example: 100
        accountingConsultants:
          type: array
          description: List of accounting consultants
          items:
            $ref: '#/components/schemas/AccountingConsultant'
    RecipientInfo:
      type: object
      description: Recipient/consultant information
      properties:
        id:
          type: string
          description: Recipient ID
          example: recipient123
        integrationPluginName:
          type: string
          description: Integration plugin name
          example: integration plugin name
        recipientName:
          type: string
          description: Display name of recipient
          example: Test Integration
        originalRecipientName:
          type: string
          nullable: true
          description: Original recipient name
          example: Test
        customRecipientName:
          type: string
          nullable: true
          description: Custom recipient name
          example: Custom Test
        email:
          type: string
          nullable: true
          description: Recipient email
          example: integration@test.com
        errorEmail:
          type: string
          nullable: true
          description: Error notification email
          example: errors@test.com
        sortOrder:
          type: integer
          description: Sort order of recipient
          example: 1
        status:
          type: string
          description: Recipient status
          example: NORMAL
        doDebitAccounting:
          type: boolean
          description: Whether recipient does debit accounting
          example: true
        doCreditAccounting:
          type: boolean
          description: Whether recipient does credit accounting
          example: true
        usesAccountingNumbers:
          type: boolean
          description: Whether recipient uses accounting numbers
          example: true
        usesSalaryCodes:
          type: boolean
          description: Whether recipient uses salary codes
          example: false
        requiresApiKey:
          type: boolean
          description: Whether recipient requires API key
          example: true
        hasApiKey:
          type: boolean
          nullable: true
          description: Whether recipient has API key configured
          example: true
        settings:
          type: object
          description: Recipient settings configuration
          additionalProperties: true
    AccountingConsultant:
      type: object
      description: Accounting consultant information
      properties:
        id:
          type: string
          description: Consultant ID
          example: consultant123
        firstName:
          type: string
          description: First name of consultant
          example: John
        lastName:
          type: string
          description: Last name of consultant
          example: Doe
        email:
          type: string
          description: Email of consultant
          example: john.doe@consultant.com
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````