> ## Documentation Index > Fetch the complete documentation index at: https://docs.gcore.com/llms.txt > Use this file to discover all available pages before exploring further. # List proxy profiles > List proxy profiles with optional filtering by client, status, and search (matches name, origin IP, or protected IP). Sorting by default is by 'created_at' field desc. ## OpenAPI ````yaml /api-reference/services_docs_mintlify_enriched/edge_proxy_api.yaml get /security/edgeproxy/v3/profiles openapi: 3.1.0 info: title: Gcore OpenAPI – Edge Proxy API description: >- This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS Protection, Object Storage, Streaming, and FastEdge services. version: 6fbf2663b9b9 servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: Proxy profiles description: >- Create and manage Edge Proxy profiles: origin, protected address and port-based ACL rules. - name: Proxy templates description: Browse proxy templates and the policies they offer for profile ACL rules. paths: /security/edgeproxy/v3/profiles: get: tags: - Proxy profiles summary: List proxy profiles description: >- List proxy profiles with optional filtering by client, status, and search (matches name, origin IP, or protected IP). Sorting by default is by 'created_at' field desc. operationId: listProxyProfiles parameters: - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/ProxyProfileStatus' - type: 'null' title: Status - name: search in: query required: false schema: anyOf: - type: string maxLength: 255 - type: 'null' description: Search by name, origin IP or protected IP title: Search description: Search by name, origin IP or protected IP - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 default: 100 title: Limit - name: offset in: query required: false schema: type: integer maximum: 1000000000 minimum: 0 default: 0 title: Offset - name: order_by in: query required: false schema: anyOf: - type: string maxLength: 255 - type: 'null' description: >- Comma-separated sort fields, e.g. 'created_at.desc' or '-created_at' title: Order By description: Comma-separated sort fields, e.g. 'created_at.desc' or '-created_at' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PageResponse_ProxyProfileClientResponse_' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Request' '403': content: application/json: schema: $ref: '#/components/schemas/Request' description: Forbidden '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ProxyProfileStatus: type: string enum: - INACTIVE - ACTIVE - DELETED title: ProxyProfileStatus PageResponse_ProxyProfileClientResponse_: properties: count: type: integer title: Count next: anyOf: - type: string - type: 'null' title: Next previous: anyOf: - type: string - type: 'null' title: Previous results: items: $ref: '#/components/schemas/ProxyProfileClientResponse' type: array title: Results type: object required: - count - next - previous - results title: PageResponse[ProxyProfileClientResponse] example: count: 25 next: https://api.example.com/items?offset=10&limit=10 results: [] Request: properties: {} type: object title: Request HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ProxyProfileClientResponse: properties: id: type: integer title: Id description: Unique identifier of the proxy profile client_id: type: integer title: Client Id description: Identifier of the client owning this profile name: type: string title: Name description: Name of the proxy profile origin_host: type: string title: Origin Host description: Origin host (IPv4 address or FQDN) of the proxy profile protected_ip_address: anyOf: - type: string format: ipv4 - type: 'null' title: Protected Ip Address description: Protected IP address assigned to the profile status: $ref: '#/components/schemas/ProxyProfileStatus' description: Current status of the proxy profile mode: $ref: '#/components/schemas/ProxyProfileMode' description: >- Operating mode, set by the template: 'regular' proxies traffic through the edge proxy; 'shield' also routes it through the template's shield sites is_processing: type: boolean title: Is Processing description: Whether the profile is currently being processed is_error: type: boolean title: Is Error description: Whether the profile is in an error state error_details: anyOf: - $ref: '#/components/schemas/ErrorDescription' - type: 'null' description: Details of the error if the profile is in an error state created_at: type: string format: date-time title: Created At description: Timestamp when the profile was created template_id: type: integer title: Template Id description: ID of the proxy template bound to this profile rules: items: $ref: '#/components/schemas/PolicyRulesOutput' type: array title: Rules readOnly: true type: object required: - id - client_id - name - origin_host - protected_ip_address - status - mode - is_processing - is_error - error_details - created_at - template_id - rules title: ProxyProfileClientResponse example: client_id: 7 created_at: '2025-11-15T10:30:00Z' id: 42 is_error: false is_processing: false name: web-server-profile origin_host: 8.8.8.8 protected_ip_address: 10.0.0.50 rules: - mappings: - port: 80 protocol: tcp proxy_protocol: accept_proxy: true version: '2' rule_id: 3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f - port: 53 protocol: udp rule_id: 7a9e0d2c-4b1f-4c3a-8e5d-6f7a8b9c0d1e policy: allow status: ACTIVE template_id: 3 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 ProxyProfileMode: type: string enum: - regular - shield title: ProxyProfileMode ErrorDescription: properties: error: anyOf: - type: string - type: 'null' title: Error details: anyOf: - items: {} type: array - additionalProperties: true type: object - type: string - type: 'null' title: Details type: object required: - error - details title: ErrorDescription PolicyRulesOutput: properties: policy: type: string title: Policy description: Policy that this group of mappings is associated with mappings: items: $ref: '#/components/schemas/RuleMappingOutput' type: array minItems: 1 title: Mappings description: Protocol/port mappings for this policy type: object required: - policy - mappings title: PolicyRules example: mappings: - port: 2222 protocol: tcp policy: minecraft RuleMappingOutput: properties: protocol: $ref: '#/components/schemas/ACLProtocol' description: Protocol for the ACL rule proxy_protocol: anyOf: - $ref: '#/components/schemas/ProxyProtocolSettingsOutput' - type: 'null' description: PROXY protocol settings for this rule; omit or null to disable outbound_port: anyOf: - type: integer maximum: 65535 minimum: 1 - type: 'null' title: Outbound Port description: >- Origin port to connect to for this rule; omit to mirror the inbound port (default behavior) rule_id: type: string format: uuid title: Rule Id description: >- Persistent id of this mapping. Echo it on update to keep the mapping's identity; a mapping sent without it is a new mapping port: type: integer maximum: 65535 minimum: 1 title: Port description: Destination port type: object required: - protocol - port title: RuleMapping example: port: 2222 protocol: tcp ACLProtocol: type: string enum: - tcp - udp title: ACLProtocol ProxyProtocolSettingsOutput: properties: version: type: string enum: - '1' - '2' title: Version description: PROXY protocol version (UDP rules must use "2") default: '2' accept_proxy: type: boolean title: Accept Proxy description: Whether this rule accepts PROXY protocol default: false type: object required: - version - accept_proxy title: ProxyProtocolSettings example: accept_proxy: false version: '2' securitySchemes: APIKey: description: >- API key for authentication. Make sure to include the word `apikey`, followed by a single space and then your token. Example: `apikey 1234_abcdef` type: apiKey in: header name: Authorization ````