--- title: Prefixes --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Addressing](https://developers.cloudflare.com/api/typescript/resources/addressing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Prefixes ##### [List Prefixes](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/methods/list) client.addressing.prefixes.list(PrefixListParams {account\_id } params, RequestOptionsoptions?): SinglePage< [Prefix]() {id, account\_id, advertised, 15 more } > GET/accounts/{account\_id}/addressing/prefixes ##### [Prefix Details](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/methods/get) client.addressing.prefixes.get(stringprefixID, PrefixGetParams {account\_id } params, RequestOptionsoptions?): [Prefix]() {id, account\_id, advertised, 15 more } GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id} ##### [Add Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/methods/create) client.addressing.prefixes.create(PrefixCreateParams {account\_id, asn, cidr, 3 more } params, RequestOptionsoptions?): [Prefix]() {id, account\_id, advertised, 15 more } POST/accounts/{account\_id}/addressing/prefixes ##### [Update Prefix Description](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/methods/edit) client.addressing.prefixes.edit(stringprefixID, PrefixEditParams {account\_id, description } params, RequestOptionsoptions?): [Prefix]() {id, account\_id, advertised, 15 more } PATCH/accounts/{account\_id}/addressing/prefixes/{prefix\_id} ##### [Delete Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/methods/delete) client.addressing.prefixes.delete(stringprefixID, PrefixDeleteParams {account\_id } params, RequestOptionsoptions?): [PrefixDeleteResponse]() {errors, messages, success } DELETE/accounts/{account\_id}/addressing/prefixes/{prefix\_id} ##### [Validate Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/methods/validate) client.addressing.prefixes.validate(stringprefixID, PrefixValidateParams {account\_id } params, RequestOptionsoptions?): [Prefix]() {id, account\_id, advertised, 15 more } POST/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/validate ##### ModelsExpand Collapse

Prefix {id, account\_id, advertised, 15 more }

id?: string Identifier of an IP Prefix. maxLength32 Link to this property account\_id?: string Identifier of a Cloudflare account. maxLength32 Link to this property Deprecatedadvertised?: boolean| null Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Prefix advertisement status to the Internet. This field is only not ‘null’ if on demand is enabled. Link to this property Deprecatedadvertised\_modified\_at?: string| null Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Last time the advertisement status was changed. This field is only not ‘null’ if on demand is enabled. formatdate-time Link to this property approved?: string Approval state of the prefix (P = pending, V = active). Link to this property asn?: number Autonomous System Number (ASN) the prefix will be advertised under. Link to this property cidr?: string IP Prefix in Classless Inter-Domain Routing format. Link to this property created\_at?: string formatdate-time Link to this property delegate\_loa\_creation?: boolean Whether Cloudflare is allowed to generate the LOA document on behalf of the prefix owner. Link to this property description?: string Description of the prefix. maxLength1000 Link to this property irr\_validation\_state?: string State of one kind of validation for an IP prefix. Link to this property loa\_document\_id?: string| null Identifier for the uploaded LOA document. maxLength32 Link to this property modified\_at?: string formatdate-time Link to this property Deprecatedon\_demand\_enabled?: boolean Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Whether advertisement of the prefix to the Internet may be dynamically enabled or disabled. Link to this property Deprecatedon\_demand\_locked?: boolean Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Whether advertisement status of the prefix is locked, meaning it cannot be changed. Link to this property ownership\_validation\_state?: string State of one kind of validation for an IP prefix. Link to this property ownership\_validation\_token?: string Token provided to demonstrate ownership of the prefix. Link to this property rpki\_validation\_state?: string State of one kind of validation for an IP prefix. Link to this property

[Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(model)%20prefix%20%3E%20(schema)>)

PrefixDeleteResponse {errors, messages, success }

errors: Array<Error>

code: number minimum1000 Link to this property message: string Link to this property documentation\_url?: string Link to this property

source?: Source {pointer }

pointer?: string Link to this property

Link to this property

messages: Array<Message>

code: number minimum1000 Link to this property message: string Link to this property documentation\_url?: string Link to this property

source?: Source {pointer }

pointer?: string Link to this property

Link to this property

Link to this property success: true Whether the API call was successful. Link to this property

[Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(model)%20prefix_delete_response%20%3E%20(schema)>) #### PrefixesService Bindings ##### [List Service Bindings](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/service_bindings/methods/list) client.addressing.prefixes.serviceBindings.list(stringprefixID, ServiceBindingListParams {account\_id } params, RequestOptionsoptions?): SinglePage< [ServiceBinding]() {id, cidr, provisioning, 2 more } > GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bindings ##### [Get Service Binding](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/service_bindings/methods/get) client.addressing.prefixes.serviceBindings.get(stringbindingID, ServiceBindingGetParams {account\_id, prefix\_id } params, RequestOptionsoptions?): [ServiceBinding]() {id, cidr, provisioning, 2 more } GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bindings/{binding\_id} ##### [Create Service Binding](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/service_bindings/methods/create) client.addressing.prefixes.serviceBindings.create(stringprefixID, ServiceBindingCreateParams {account\_id, cidr, service\_id } params, RequestOptionsoptions?): [ServiceBinding]() {id, cidr, provisioning, 2 more } POST/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bindings ##### [Delete Service Binding](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/service_bindings/methods/delete) client.addressing.prefixes.serviceBindings.delete(stringbindingID, ServiceBindingDeleteParams {account\_id, prefix\_id } params, RequestOptionsoptions?): [ServiceBindingDeleteResponse]() {errors, messages, success } DELETE/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bindings/{binding\_id} ##### ModelsExpand Collapse

ServiceBinding {id, cidr, provisioning, 2 more }

id?: string Identifier of a Service Binding. maxLength32 Link to this property cidr?: string IP Prefix in Classless Inter-Domain Routing format. Link to this property

provisioning?: Provisioning {state } Status of a Service Binding’s deployment to the Cloudflare network

state?: "provisioning"| "active"| "magic\_transit\_route\_missing" When a binding has been deployed to a majority of Cloudflare datacenters, the binding will become active and can be used with its associated service.

One of the following: "provisioning" Link to this property "active" Link to this property "magic\_transit\_route\_missing" Link to this property

Link to this property

Link to this property service\_id?: string Identifier of a Service on the Cloudflare network. Available services and their IDs may be found in the **List Services** endpoint. maxLength32 Link to this property service\_name?: string Name of a service running on the Cloudflare network Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.service_bindings%20%3E%20(model)%20service_binding%20%3E%20(schema)>)

ServiceBindingDeleteResponse {errors, messages, success }

errors: Array<Error>

code: number minimum1000 Link to this property message: string Link to this property documentation\_url?: string Link to this property

source?: Source {pointer }

pointer?: string Link to this property

Link to this property

messages: Array<Message>

code: number minimum1000 Link to this property message: string Link to this property documentation\_url?: string Link to this property

source?: Source {pointer }

pointer?: string Link to this property

Link to this property

Link to this property success: true Whether the API call was successful. Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.service_bindings%20%3E%20(model)%20service_binding_delete_response%20%3E%20(schema)>) #### PrefixesBGP Prefixes ##### [List BGP Prefixes](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/bgp_prefixes/methods/list) client.addressing.prefixes.bgpPrefixes.list(stringprefixID, BGPPrefixListParams {account\_id } params, RequestOptionsoptions?): SinglePage< [BGPPrefix]() {id, asn, asn\_prepend\_count, 6 more } > GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/prefixes ##### [Fetch BGP Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/bgp_prefixes/methods/get) client.addressing.prefixes.bgpPrefixes.get(stringbgpPrefixID, BGPPrefixGetParams {account\_id, prefix\_id } params, RequestOptionsoptions?): [BGPPrefix]() {id, asn, asn\_prepend\_count, 6 more } GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/prefixes/{bgp\_prefix\_id} ##### [Create BGP Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/bgp_prefixes/methods/create) client.addressing.prefixes.bgpPrefixes.create(stringprefixID, BGPPrefixCreateParams {account\_id, cidr } params, RequestOptionsoptions?): [BGPPrefix]() {id, asn, asn\_prepend\_count, 6 more } POST/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/prefixes ##### [Update BGP Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/bgp_prefixes/methods/edit) client.addressing.prefixes.bgpPrefixes.edit(stringbgpPrefixID, BGPPrefixEditParams {account\_id, prefix\_id, asn\_prepend\_count, 2 more } params, RequestOptionsoptions?): [BGPPrefix]() {id, asn, asn\_prepend\_count, 6 more } PATCH/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/prefixes/{bgp\_prefix\_id} ##### [Delete BGP Prefix](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/bgp_prefixes/methods/delete) client.addressing.prefixes.bgpPrefixes.delete(stringbgpPrefixID, BGPPrefixDeleteParams {account\_id, prefix\_id } params, RequestOptionsoptions?): [BGPPrefixDeleteResponse]() {errors, messages, success } DELETE/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/prefixes/{bgp\_prefix\_id} ##### ModelsExpand Collapse

BGPPrefix {id, asn, asn\_prepend\_count, 6 more }

id?: string Identifier of BGP Prefix. maxLength32 Link to this property asn?: number| null Autonomous System Number (ASN) the prefix will be advertised under. Link to this property asn\_prepend\_count?: number Number of times to prepend the Cloudflare ASN to the BGP AS-Path attribute maximum3 minimum0 Link to this property auto\_advertise\_withdraw?: boolean Determines if Cloudflare advertises a BYOIP BGP prefix even when there is no matching BGP prefix in the Magic routing table. When true, Cloudflare will automatically withdraw the BGP prefix when there are no matching BGP routes, and will resume advertising when there is at least one matching BGP route. Link to this property

bgp\_signal\_opts?: BGPSignalOpts {enabled, modified\_at }

enabled?: boolean Whether control of advertisement of the prefix to the Internet is enabled to be performed via BGP signal Link to this property modified\_at?: string| null Last time BGP signaling control was toggled. This field is null if BGP signaling has never been enabled. formatdate-time Link to this property

Link to this property cidr?: string IP Prefix in Classless Inter-Domain Routing format. Link to this property created\_at?: string formatdate-time Link to this property modified\_at?: string formatdate-time Link to this property

on\_demand?: OnDemand {advertised, advertised\_modified\_at, on\_demand\_enabled, on\_demand\_locked }

advertised?: boolean| null Prefix advertisement status to the Internet. This field is only not ‘null’ if on demand is enabled. Link to this property advertised\_modified\_at?: string| null Last time the advertisement status was changed. This field is only not ‘null’ if on demand is enabled. formatdate-time Link to this property on\_demand\_enabled?: boolean Whether advertisement of the prefix to the Internet may be dynamically enabled or disabled. Link to this property on\_demand\_locked?: boolean Whether the advertisement status of the prefix is locked, meaning it cannot be changed. Link to this property

Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.bgp_prefixes%20%3E%20(model)%20bgp_prefix%20%3E%20(schema)>)

BGPPrefixDeleteResponse {errors, messages, success }

errors: Array<Error>

code: number minimum1000 Link to this property message: string Link to this property documentation\_url?: string Link to this property

source?: Source {pointer }

pointer?: string Link to this property

Link to this property

messages: Array<Message>

code: number minimum1000 Link to this property message: string Link to this property documentation\_url?: string Link to this property

source?: Source {pointer }

pointer?: string Link to this property

Link to this property

Link to this property success: true Whether the API call was successful. Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.bgp_prefixes%20%3E%20(model)%20bgp_prefix_delete_response%20%3E%20(schema)>) #### PrefixesAdvertisement Status ##### [Get Advertisement Status](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/advertisement_status/methods/get) Deprecated client.addressing.prefixes.advertisementStatus.get(stringprefixID, AdvertisementStatusGetParams {account\_id } params, RequestOptionsoptions?): [AdvertisementStatusGetResponse]() {advertised, advertised\_modified\_at } GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/status ##### [Update Prefix Dynamic Advertisement Status](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/advertisement_status/methods/edit) Deprecated client.addressing.prefixes.advertisementStatus.edit(stringprefixID, AdvertisementStatusEditParams {account\_id, advertised } params, RequestOptionsoptions?): [AdvertisementStatusEditResponse]() {advertised, advertised\_modified\_at } PATCH/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/bgp/status ##### ModelsExpand Collapse

AdvertisementStatusGetResponse {advertised, advertised\_modified\_at }

advertised?: boolean Advertisement status of the prefix. If true, the BGP route for the prefix is advertised to the Internet. If false, the BGP route is withdrawn. Link to this property advertised\_modified\_at?: string| null Last time the advertisement status was changed. This field is only not ‘null’ if on demand is enabled. formatdate-time Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.advertisement_status%20%3E%20(model)%20advertisement_status_get_response%20%3E%20(schema)>)

AdvertisementStatusEditResponse {advertised, advertised\_modified\_at }

[Link to this property](<#(resource)%20addressing.prefixes.advertisement_status%20%3E%20(model)%20advertisement_status_edit_response%20%3E%20(schema)>) #### PrefixesDelegations ##### [List Prefix Delegations](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/delegations/methods/list) client.addressing.prefixes.delegations.list(stringprefixID, DelegationListParams {account\_id } params, RequestOptionsoptions?): SinglePage< [Delegations]() {id, cidr, created\_at, 3 more } > GET/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/delegations ##### [Create Prefix Delegation](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/delegations/methods/create) client.addressing.prefixes.delegations.create(stringprefixID, DelegationCreateParams {account\_id, cidr, delegated\_account\_id } params, RequestOptionsoptions?): [Delegations]() {id, cidr, created\_at, 3 more } POST/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/delegations ##### [Delete Prefix Delegation](https://developers.cloudflare.com/api/typescript/resources/addressing/subresources/prefixes/subresources/delegations/methods/delete) client.addressing.prefixes.delegations.delete(stringdelegationID, DelegationDeleteParams {account\_id, prefix\_id } params, RequestOptionsoptions?): [DelegationDeleteResponse]() {id } DELETE/accounts/{account\_id}/addressing/prefixes/{prefix\_id}/delegations/{delegation\_id} ##### ModelsExpand Collapse

Delegations {id, cidr, created\_at, 3 more }

id?: string Identifier of a Delegation. maxLength32 Link to this property cidr?: string IP Prefix in Classless Inter-Domain Routing format. Link to this property created\_at?: string formatdate-time Link to this property delegated\_account\_id?: string Account identifier for the account to which prefix is being delegated. maxLength32 Link to this property modified\_at?: string formatdate-time Link to this property parent\_prefix\_id?: string Identifier of an IP Prefix. maxLength32 Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.delegations%20%3E%20(model)%20delegations%20%3E%20(schema)>)

DelegationDeleteResponse {id }

id?: string Identifier of a Delegation. maxLength32 Link to this property

[Link to this property](<#(resource)%20addressing.prefixes.delegations%20%3E%20(model)%20delegation_delete_response%20%3E%20(schema)>)