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

# List credentials

> Returns a paginated list of all credentials belonging to the authenticated user across every package. Accepts standard pagination query parameters and responds with the credential items plus pagination metadata.



## OpenAPI

````yaml /api-reference/credentials-ref.yaml get /credentials
openapi: 3.1.0
info:
  title: App Credentials
  version: v1
servers:
  - description: Droidrun Cloud API
    url: https://api.mobilerun.ai/v1
security:
  - bearerAuth: []
paths:
  /credentials:
    get:
      tags:
        - App Credentials
      summary: List credentials
      description: >-
        Returns a paginated list of all credentials belonging to the
        authenticated user across every package. Accepts standard pagination
        query parameters and responds with the credential items plus pagination
        metadata.
      operationId: listAllUserCredentials
      parameters:
        - in: query
          name: page
          required: false
          schema:
            default: 1
            exclusiveMinimum: 0
            type: integer
        - in: query
          name: pageSize
          required: false
          schema:
            default: 10
            exclusiveMinimum: 0
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CredentialList'
          description: Credentials retrieved successfully
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
          description: Unauthorized
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CredentialErrorResponse'
          description: Credential source rate limited
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
          description: Internal Server Error
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Mobilerun from '@mobilerun/sdk';

            const client = new Mobilerun({
              apiKey: process.env['MOBILERUN_CLOUD_API_KEY'], // This is the default and can be omitted
            });

            const credentials = await client.credentials.list();

            console.log(credentials.items);
        - lang: Python
          source: |-
            import os
            from mobilerun_sdk import Mobilerun

            client = Mobilerun(
                api_key=os.environ.get("MOBILERUN_CLOUD_API_KEY"),  # This is the default and can be omitted
            )
            credentials = client.credentials.list()
            print(credentials.items)
components:
  schemas:
    CredentialList:
      properties:
        items:
          items:
            $ref: '#/components/schemas/Credential'
          type: array
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
        - items
        - pagination
      type: object
    ApiErrorEnvelope:
      properties:
        code:
          type: string
        details: {}
        message:
          type: string
        retryAfterSeconds:
          type: number
        traceId:
          type: string
      required:
        - code
        - message
      type: object
    CredentialErrorResponse:
      properties:
        code:
          $ref: '#/components/schemas/CredentialErrorCode'
        message:
          type: string
      required:
        - code
        - message
      type: object
    InternalServerError:
      properties:
        code:
          type: string
        message:
          type: string
        traceId:
          type: string
      required:
        - code
        - message
      type: object
    Credential:
      properties:
        createdBy:
          type:
            - string
            - 'null'
        credentialName:
          type: string
        fields:
          items:
            properties:
              fieldType:
                enum:
                  - email
                  - username
                  - password
                  - api_token
                  - phone_number
                  - two_factor_secret
                  - backup_codes
                type: string
              value:
                minLength: 1
                type: string
            required:
              - fieldType
              - value
            type: object
          type: array
        link:
          properties:
            fieldMap:
              items:
                properties:
                  fieldId:
                    minLength: 1
                    type: string
                  fieldType:
                    enum:
                      - email
                      - username
                      - password
                      - api_token
                      - phone_number
                      - two_factor_secret
                      - backup_codes
                    type: string
                required:
                  - fieldType
                  - fieldId
                type: object
              minItems: 1
              type: array
            itemId:
              minLength: 1
              type: string
            itemTitle:
              type: string
            provider:
              enum:
                - onepassword
              type: string
            vaultId:
              minLength: 1
              type: string
            vaultName:
              type: string
          required:
            - provider
            - vaultId
            - vaultName
            - itemId
            - itemTitle
            - fieldMap
          type: object
        ownerId:
          type: string
        packageName:
          type: string
        secretPath:
          type: string
        source:
          enum:
            - mobilerun
            - onepassword
          type: string
        userId:
          deprecated: true
          description: >-
            Deprecated: use createdBy (same value — the creating actor). Null
            for credentials created before rollout.
          type:
            - string
            - 'null'
      required:
        - ownerId
        - createdBy
        - userId
        - packageName
        - secretPath
        - credentialName
        - fields
      type: object
    Pagination:
      properties:
        hasNext:
          type: boolean
        hasPrev:
          type: boolean
        page:
          minimum: 1
          type: integer
        pageSize:
          minimum: 1
          type: integer
        pages:
          minimum: 0
          type: integer
        total:
          minimum: 0
          type: integer
      required:
        - hasNext
        - hasPrev
        - page
        - pageSize
        - pages
        - total
      type: object
    CredentialErrorCode:
      enum:
        - credential_read_only
        - credential_source_unavailable
        - credential_source_rate_limited
        - onepassword_not_connected
        - onepassword_token_invalid
        - onepassword_no_vaults
        - onepassword_reference_invalid
        - invalid_request
        - package_exists
        - credential_not_found
        - proxy_not_found
        - create_failed
        - update_failed
        - protocol_change_not_allowed
      type: string
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque
      description: Bearer token via Authorization header
      scheme: bearer
      type: http

````

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