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

# List your users

> Every end user you have registered, newest first.



## OpenAPI

````yaml /openapi/managed.json get /users
openapi: 3.1.0
info:
  title: Synci
  version: '1.0'
  description: >-
    Register and manage the end users your Managed app pays for. Authenticate
    with HTTP Basic using your app's client id and client secret. See the
    Managed apps guide for the full flow.
servers:
  - url: https://api.synci.io/managed/v1
security:
  - basicAuth: []
tags:
  - name: Managed Users
  - name: Managed Connections
  - name: Managed Webhooks
paths:
  /users:
    get:
      tags:
        - Managed Users
      summary: List your users
      description: Every end user you have registered, newest first.
      operationId: managed.users.index
      responses:
        '200':
          description: Paginated set of `ManagedUserResource`
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ManagedUserResource'
                  links:
                    type: object
                    properties:
                      first:
                        type:
                          - string
                          - 'null'
                      last:
                        type:
                          - string
                          - 'null'
                      prev:
                        type:
                          - string
                          - 'null'
                      next:
                        type:
                          - string
                          - 'null'
                    required:
                      - first
                      - last
                      - prev
                      - next
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        minimum: 1
                      from:
                        type:
                          - integer
                          - 'null'
                        minimum: 1
                      last_page:
                        type: integer
                        minimum: 1
                      links:
                        type: array
                        description: Generated paginator links.
                        items:
                          type: object
                          properties:
                            url:
                              type:
                                - string
                                - 'null'
                            label:
                              type: string
                            active:
                              type: boolean
                          required:
                            - url
                            - label
                            - active
                      path:
                        type:
                          - string
                          - 'null'
                        description: Base path for paginator generated URLs.
                      per_page:
                        type: integer
                        description: Number of items shown per page.
                        minimum: 0
                      to:
                        type:
                          - integer
                          - 'null'
                        description: Number of the last item in the slice.
                        minimum: 1
                      total:
                        type: integer
                        description: Total number of items being paginated.
                        minimum: 0
                    required:
                      - current_page
                      - from
                      - last_page
                      - links
                      - path
                      - per_page
                      - to
                      - total
                required:
                  - data
                  - links
                  - meta
components:
  schemas:
    ManagedUserResource:
      type: object
      properties:
        user_id:
          type: string
        external_user_id:
          type: string
        email:
          type: string
        email_verified:
          type: boolean
          description: |-
            Whether this person has proven they control the address, by
            redeeming a sign-in code Synci emailed there. Arriving through a
            portal link you minted does not set it. While false, Synci cannot
            tell a working address from a mistyped one, so its connection
            emails (expiry, failure, disablement) may not reach them.
        onboarded_at:
          type: string
          description: First time they reached the portal, by either route.
        limits:
          type: object
          properties:
            financial_connections:
              type: string
              description: |-
                Every connection type the user may hold, brokerage and
                crypto included, not just bank. Named to match the plan-limit
                feature key of the same name.
          required:
            - financial_connections
        connections_count:
          type: integer
        created_at:
          type: string
      required:
        - user_id
        - external_user_id
        - email
        - email_verified
        - onboarded_at
        - limits
        - created_at
      title: ManagedUserResource
  securitySchemes:
    basicAuth:
      type: http
      description: |-
        **Username = your client id. Password = your client secret.**

        So the base64-encoded `username:password` described below is
        `client_id:client_secret`:

        ```
        Authorization: Basic base64(YOUR_CLIENT_ID:YOUR_CLIENT_SECRET)
        ```

        Most HTTP clients build that header for you:

        ```bash
        curl -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
             https://api.synci.io/managed/v1/users
        ```

        Both values come from **Developers → Apps → your app**. The
        secret is shown once at creation and is prefixed `oac_`.
      scheme: basic

````

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