> ## Documentation Index > Fetch the complete documentation index at: https://gcore.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List DDoS protection profiles > This endpoint returns a comprehensive list of all DDoS protection profiles associated with the specified project and region. Each profile contains detailed information about the protection configuration including IP addresses, profile templates, field values, activation status, and current operational state. ## OpenAPI ````yaml /api-reference/services_documented/cloud_api.yaml get /cloud/v1/ddos/profiles/{project_id}/{region_id} openapi: 3.1.0 info: title: Gcore OpenAPI – Cloud 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: '2026-05-15T06:37:28.230198+00:00' servers: - url: https://api.gcore.com security: - APIKey: [] tags: - name: Bare Metal x-displayName: Bare Metal - name: Container as a Service x-displayName: Container as a Service - name: Cost Reports x-displayName: Cost Reports - name: DDoS Protection x-displayName: DDoS Protection - name: Everywhere Inference x-displayName: Everywhere Inference - name: Everywhere Inference Apps x-displayName: Everywhere Inference Apps - name: File Shares x-displayName: File Shares - name: Floating IPs x-displayName: Floating IPs - name: Function as a Service x-displayName: Function as a Service - name: GPU Bare Metal x-displayName: GPU Bare Metal - name: GPU Virtual x-displayName: GPU Virtual - name: IP Ranges x-displayName: IP Ranges - name: Images x-displayName: Images - name: Instances x-displayName: Instances - name: Load Balancers x-displayName: Load Balancers - name: Logging x-displayName: Logging - name: Managed Kubernetes x-displayName: Managed Kubernetes - name: Managed PostgreSQL x-displayName: Managed PostgreSQL - name: Networks x-displayName: Networks - name: Placement Groups x-displayName: Placement Groups - name: Projects x-displayName: Projects - name: Quotas x-displayName: Quotas - name: Regions x-displayName: Regions - name: Registry x-displayName: Registry - name: Reservations x-displayName: Reservations - name: Reserved IPs x-displayName: Reserved IPs - name: Routers x-displayName: Routers - name: SSH Keys x-displayName: SSH Keys - name: Secrets x-displayName: Secrets - name: Security Groups x-displayName: Security Groups - name: Snapshot Schedules x-displayName: Snapshot Schedules - name: Snapshots x-displayName: Snapshots - name: Tasks x-displayName: Tasks - name: User Actions x-displayName: User Actions - name: User Role Assignments x-displayName: User Role Assignments - name: Volumes x-displayName: Volumes paths: /cloud/v1/ddos/profiles/{project_id}/{region_id}: get: tags: - DDoS Protection summary: List DDoS protection profiles description: >- This endpoint returns a comprehensive list of all DDoS protection profiles associated with the specified project and region. Each profile contains detailed information about the protection configuration including IP addresses, profile templates, field values, activation status, and current operational state. operationId: ProfilesHandler.get parameters: - in: path name: project_id required: true description: >- Unique identifier of the cloud project that owns the DDoS protection resources schema: description: >- Unique identifier of the cloud project that owns the DDoS protection resources example: 1 examples: - 1 title: Project Id type: integer - in: path name: region_id required: true description: >- Unique identifier of the cloud region where DDoS protection operations will be performed schema: description: >- Unique identifier of the cloud region where DDoS protection operations will be performed example: 1 examples: - 1 title: Region Id type: integer - in: query name: limit required: false description: Limit of items on a single page schema: default: 1000 description: Limit of items on a single page example: 1000 examples: - 1000 exclusiveMinimum: 0 maximum: 1000 title: Limit type: integer - in: query name: managed_by required: false description: >- Specifies the entity responsible for managing the resource. - `user`: The profile is created and maintained directly by the user. - `system`: The profile is created and maintained automatically by the system. schema: description: >- Specifies the entity responsible for managing the resource. - `user`: The profile is created and maintained directly by the user. - `system`: The profile is created and maintained automatically by the system. example: user examples: - user items: $ref: '#/components/schemas/DdosManagedBy' title: Managed By type: array - in: query name: offset required: false description: Offset in results list schema: default: 0 description: Offset in results list example: 0 examples: - 0 minimum: 0 title: Offset type: integer - in: query name: order_by required: false description: Sort results by field and direction schema: $ref: '#/components/schemas/DdosProfileOrderByChoices' default: id.asc description: Sort results by field and direction examples: - id.asc responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ClientProfileSerializerList' components: schemas: DdosManagedBy: enum: - system - user title: DdosManagedBy type: string DdosProfileOrderByChoices: enum: - id.asc - id.desc - ip_address.asc - ip_address.desc - managed_by.asc - managed_by.desc - site.asc - site.desc - status.asc - status.desc title: DdosProfileOrderByChoices type: string ClientProfileSerializerList: properties: count: description: Number of objects example: 1 examples: - 1 minimum: 0 title: Count type: integer results: description: Objects items: $ref: '#/components/schemas/ClientProfileSerializer' title: Results type: array required: - count - results title: ClientProfileSerializerList type: object ClientProfileSerializer: properties: fields: description: List of configured field values for the protection profile items: $ref: '#/components/schemas/ClientProfileFieldSerializer' title: Fields type: array id: description: Unique identifier for the DDoS protection profile example: 0 examples: - 0 title: Id type: integer ip_address: anyOf: - format: ipv4 type: string - format: ipv6 type: string - format: ipv4network type: string - format: ipv6network type: string - type: 'null' description: >- IP address or network range (CIDR) that is protected by this DDoS profile examples: - 203.0.113.1 - 203.0.113.0/24 title: Ip Address managed_by: $ref: '#/components/schemas/DdosManagedBy' description: Specifies the entity responsible for managing the resource. examples: - user options: $ref: '#/components/schemas/ProfileOptionsSerializer' description: Configuration options controlling profile activation and BGP routing examples: - active: true bgp: true profile_template: anyOf: - $ref: '#/components/schemas/ClientProfileTemplateSerializer' - type: 'null' description: Complete template configuration data used for this profile profile_template_description: anyOf: - type: string - type: 'null' description: >- Detailed description of the protection template used for this profile examples: - ARK server ports. Valid port values are in range 1000-65535 title: Profile Template Description protocols: anyOf: - items: $ref: '#/components/schemas/ProtocolsOnPortSerializer' type: array - type: 'null' description: List of network protocols and ports configured for protection examples: - - port: '80' protocols: - TCP - HTTP - port: '53' protocols: - UDP title: Protocols site: anyOf: - maxLength: 50 type: string - type: 'null' description: Geographic site identifier where the protection is deployed examples: - ED title: Site status: anyOf: - $ref: '#/components/schemas/DdosProfileStatusSerializer' - type: 'null' description: Current operational status and any error information for the profile examples: - error_description: '' status: Updated required: - id - options - site - protocols - status - profile_template_description - profile_template - fields - ip_address - managed_by title: ClientProfileSerializer type: object ClientProfileFieldSerializer: properties: base_field: description: ID of DDoS profile field example: 10 examples: - 10 title: Base Field type: integer default: anyOf: - maxLength: 100 type: string - type: 'null' description: Predefined default value for the field if not specified examples: - null title: Default description: anyOf: - maxLength: 255 type: string - type: 'null' description: >- Detailed description explaining the field's purpose and usage guidelines examples: - ARK server ports. Valid port values are in range 1000-65535 title: Description field_type: anyOf: - type: string - type: 'null' description: Data type classification of the field (e.g., string, integer, array) examples: - null title: Field Type field_value: description: Complex value for the DDoS profile field examples: - 45046 - 45047 title: Field Value id: description: Unique identifier for the DDoS protection field example: 11 examples: - 11 title: Id type: integer name: description: Human-readable name of the protection field example: ARK Ports examples: - ARK Ports maxLength: 30 title: Name type: string required: anyOf: - type: boolean - type: 'null' description: >- Indicates whether this field must be provided when creating a protection profile examples: - true title: Required validation_schema: description: >- JSON schema defining validation rules and constraints for the field value examples: - items: maximum: 65535 minimum: 1000 type: integer minItems: 1 type: array title: Validation Schema required: - id - name - description - field_type - required - default - validation_schema - field_value - base_field title: ClientProfileFieldSerializer type: object ProfileOptionsSerializer: properties: active: description: >- Controls whether the DDoS protection profile is enabled and actively protecting the resource example: true examples: - true title: Active type: boolean bgp: description: >- Enables Border Gateway Protocol (BGP) routing for DDoS protection traffic example: true examples: - true title: Bgp type: boolean required: - active - bgp title: ProfileOptionsSerializer type: object ClientProfileTemplateSerializer: properties: description: anyOf: - type: string - type: 'null' description: Detailed description explaining the template's purpose and use cases examples: - description title: Description fields: description: >- List of configurable fields that define the template's protection parameters items: $ref: '#/components/schemas/ClientProfileTemplateFieldSerializer' title: Fields type: array id: description: Unique identifier for the DDoS protection template example: 123 examples: - 123 title: Id type: integer name: description: Human-readable name of the protection template example: ICMP port examples: - ICMP port maxLength: 100 title: Name type: string required: - id - name - description - fields title: ClientProfileTemplateSerializer type: object ProtocolsOnPortSerializer: properties: port: description: Network port number for which protocols are configured example: '80' examples: - '80' title: Port type: string protocols: description: List of network protocols enabled on the specified port example: - TCP - HTTP examples: - - TCP - HTTP items: type: string title: Protocols type: array required: - port - protocols title: ProtocolsOnPortSerializer type: object DdosProfileStatusSerializer: properties: error_description: description: >- Detailed error message describing any issues with the profile operation example: An error occured while deleting profile examples: - An error occured while deleting profile title: Error Description type: string status: description: Current operational status of the DDoS protection profile example: Error Deleting examples: - Error Deleting maxLength: 30 minLength: 3 title: Status type: string required: - status - error_description title: DdosProfileStatusSerializer type: object ClientProfileTemplateFieldSerializer: properties: default: anyOf: - maxLength: 100 type: string - type: 'null' description: Predefined default value for the field if not specified examples: - null title: Default description: anyOf: - maxLength: 255 type: string - type: 'null' description: >- Detailed description explaining the field's purpose and usage guidelines examples: - ARK server ports. Valid port values are in range 1000-65535 title: Description field_type: anyOf: - type: string - type: 'null' description: Data type classification of the field (e.g., string, integer, array) examples: - null title: Field Type id: description: Unique identifier for the DDoS protection field example: 11 examples: - 11 title: Id type: integer name: description: Human-readable name of the protection field example: ARK Ports examples: - ARK Ports maxLength: 30 title: Name type: string required: anyOf: - type: boolean - type: 'null' description: >- Indicates whether this field must be provided when creating a protection profile examples: - true title: Required validation_schema: description: >- JSON schema defining validation rules and constraints for the field value examples: - items: maximum: 65535 minimum: 1000 type: integer minItems: 1 type: array title: Validation Schema required: - id - name - description - field_type - required - default - validation_schema title: ClientProfileTemplateFieldSerializer type: object 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 ````