> ## Documentation Index > Fetch the complete documentation index at: https://skulabs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Distributor - Get > Retrieve a paginated list of distributors (suppliers/vendors). ## OpenAPI ````yaml get /distributor/get openapi: 3.0.3 info: title: SKULabs API description: >- Most API keys have "platformGeneric" and "platformApi" scopes included. Contact us to convert more routes from "platformUser" (only available to users) to "platformGeneric" (available to users and api keys) upon request. version: 4.5.0 servers: - url: https://api.skulabs.com - url: https://app.skulabs.com/s security: [] tags: - name: batch - name: customer description: Manage customers, tags, and notes - name: cycle_count - name: distributor - name: inventory description: Query and modify inventory levels across locations - name: inventory_table - name: item description: Manage items, barcodes, serial numbers, and tags - name: kit description: Manage kits and their component items - name: listing - name: location - name: oauth - name: order description: Manage orders, shipments, tags, and statuses - name: purchase_order description: Manage purchase orders and receiving - name: run - name: shipments - name: shipping - name: store - name: tag description: Create, update, and remove tags - name: transfer_order - name: warehouse description: Manage warehouses and view statistics - name: webhook description: Manage webhook handlers paths: /distributor/get: get: tags: - distributor summary: Distributor - Get description: Retrieve a paginated list of distributors (suppliers/vendors). operationId: get_distributor_get parameters: - name: selector in: query required: true schema: type: object properties: {} description: Query selector object for filtering results - name: limit in: query required: false schema: type: number description: Max results to return example: 50 - name: skip in: query required: false schema: type: number description: Number of results to skip example: 0 - name: sort in: query required: false schema: type: object properties: {} description: 'Sort fields object, e.g. { "name": 1 }' - name: fields in: query required: false schema: type: object properties: {} description: 'Projection fields object, e.g. { "name": 1 }' responses: '200': description: Array of suppliers matching the query content: application/json: schema: type: array items: $ref: '#/components/schemas/Distributor' '400': description: Bad request content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '403': description: Forbidden. Insufficient permissions. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '429': description: Too many requests. Rate limit exceeded. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '500': description: Internal server error. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error security: - SKULabsToken: [] servers: - url: https://api.skulabs.com components: schemas: Distributor: type: object properties: _id: type: string description: Unique supplier identifier example: 507f1f77bcf86cd799439011 name: type: string description: Supplier name phone: type: string nullable: true description: Supplier phone number email: type: string nullable: true description: Supplier email address active: type: boolean description: Whether the supplier is active address: $ref: '#/components/schemas/DistributorAddress' terms: type: string nullable: true description: Default payment terms shipping: type: string nullable: true description: Default shipping method memo: type: string nullable: true description: Default memo for purchase orders items: type: array items: $ref: '#/components/schemas/DistributorItem' description: Items supplied by this supplier location_id: type: string description: Default location ID for this supplier example: 507f1f77bcf86cd799439011 required: - _id - name DistributorAddress: type: object properties: street: type: string description: Street address street_2: type: string description: Street address line 2 city: type: string description: City state: type: string description: State or province zip: type: string description: ZIP or postal code country: type: string description: Country description: Supplier address DistributorItem: type: object properties: _id: type: string description: Unique distributor item entry ID example: 507f1f77bcf86cd799439011 item_id: type: string description: SKULabs item ID example: 507f1f77bcf86cd799439011 cost: type: number nullable: true description: Unit cost from this supplier quantity: type: number description: Default order quantity minimum_quantity: type: number description: Minimum order quantity lot_quantity: type: number description: Lot quantity for ordering part_number: type: string description: Supplier part number / MPN reorder_point: type: number description: Inventory level that triggers a reorder reorder_rule: type: string nullable: true description: Reorder rule expression notes: type: string nullable: true description: Notes for this supplier item securitySchemes: SKULabsToken: type: http scheme: bearer bearerFormat: JWT ````