> ## Documentation Index > Fetch the complete documentation index at: https://docs.dataraven.io/llms.txt > Use this file to discover all available pages before exploring further. # List Locations > Get all locations for a team with optional filtering, sorting, and pagination. **Required Role:** VIEWER or higher Query parameters: - location_type: Filter by provider type (s3, azure_blob, gcs, etc.) - q: Search by name (case-insensitive partial match) - sort_by: Field to sort by (name, created_at, last_verified_at) - sort_order: Sort direction (asc, desc). Default: desc - page: Page number (default: 1) - limit: Items per page (default: 50, max: 100) Returns paginated list of locations with metadata. ## OpenAPI ````yaml GET /v1/teams/{team_id}/locations openapi: 3.1.0 info: title: Data Raven API description: Cloud-to-cloud data transfer platform powered by RClone version: 0.5.0 servers: [] security: [] paths: /v1/teams/{team_id}/locations: get: tags: - Locations summary: List Locations description: >- Get all locations for a team with optional filtering, sorting, and pagination. **Required Role:** VIEWER or higher Query parameters: - location_type: Filter by provider type (s3, azure_blob, gcs, etc.) - q: Search by name (case-insensitive partial match) - sort_by: Field to sort by (name, created_at, last_verified_at) - sort_order: Sort direction (asc, desc). Default: desc - page: Page number (default: 1) - limit: Items per page (default: 50, max: 100) Returns paginated list of locations with metadata. operationId: list_locations_v1_teams__team_id__locations_get parameters: - name: team_id in: path required: true schema: type: string format: uuid title: Team Id - name: location_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/LocationType' - type: 'null' description: Filter by location type title: Location Type description: Filter by location type - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: Search by name (case-insensitive) title: Q description: Search by name (case-insensitive) - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 50 title: Limit description: Items per page - name: sort_by in: query required: false schema: anyOf: - enum: - name - created_at - last_verified_at type: string - type: 'null' description: 'Field to sort by: name, created_at, last_verified_at' title: Sort By description: 'Field to sort by: name, created_at, last_verified_at' - name: sort_order in: query required: false schema: anyOf: - $ref: '#/components/schemas/SortOrder' - type: 'null' description: 'Sort order: asc or desc (default: desc)' title: Sort Order description: 'Sort order: asc or desc (default: desc)' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_LocationResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: LocationType: type: string enum: - s3 - azure_blob - gcs - r2 - b2 - wasabi - railway - oracle_object_storage_s3 - s3_compatible - tigris - digitalocean_spaces - hetzner - rabata title: LocationType description: Cloud storage provider types. SortOrder: type: string enum: - asc - desc title: SortOrder description: Sort order for list endpoints. PaginatedResponse_LocationResponse_: properties: data: items: $ref: '#/components/schemas/LocationResponse' type: array title: Data pagination: $ref: '#/components/schemas/PaginationResponse' type: object required: - data - pagination title: PaginatedResponse[LocationResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError LocationResponse: properties: id: type: string format: uuid title: Id name: type: string title: Name location_type: $ref: '#/components/schemas/LocationType' bucket_name: type: string title: Bucket Name region: anyOf: - type: string - type: 'null' title: Region last_verified_at: anyOf: - type: string format: date-time - type: 'null' title: Last Verified At created_at: type: string format: date-time title: Created At last_verification: anyOf: - $ref: '#/components/schemas/LocationVerificationSummary' - type: 'null' description: >- Most recent verification attempt (success or failure) for health badge type: object required: - id - name - location_type - bucket_name - region - last_verified_at - created_at title: LocationResponse description: Schema for basic location information. PaginationResponse: properties: page: type: integer title: Page limit: type: integer title: Limit total: type: integer title: Total total_pages: type: integer title: Total Pages type: object required: - page - limit - total - total_pages title: PaginationResponse description: Pagination metadata in responses. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError LocationVerificationSummary: properties: id: type: string format: uuid title: Id verified: type: boolean title: Verified error_code: anyOf: - type: string - type: 'null' title: Error Code created_at: type: string format: date-time title: Created At can_list: anyOf: - type: boolean - type: 'null' title: Can List can_read: anyOf: - type: boolean - type: 'null' title: Can Read can_write: anyOf: - type: boolean - type: 'null' title: Can Write can_delete: anyOf: - type: boolean - type: 'null' title: Can Delete type: object required: - id - verified - created_at title: LocationVerificationSummary description: >- Compact verification record for embedding in list responses. Drives the health badge on LocationList — we need verified + timestamp plus the three-state permission flags so the list can distinguish fully verified from "verified but with permission gaps" (e.g. read-only users). securitySchemes: HTTPBearer: type: http scheme: bearer ````