--- title: PCAPs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Magic Transit](https://developers.cloudflare.com/api/go/resources/magic_transit) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # PCAPs ##### [List packet capture requests](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/methods/list) client.MagicTransit.PCAPs.List(ctx, query) (\*SinglePage\[[PCAPListResponse]()], error) GET/accounts/{account\_id}/pcaps ##### [Get PCAP request](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/methods/get) client.MagicTransit.PCAPs.Get(ctx, pcapID, query) (\*[PCAPGetResponse](), error) GET/accounts/{account\_id}/pcaps/{pcap\_id} ##### [Create PCAP request](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/methods/create) client.MagicTransit.PCAPs.New(ctx, params) (\*[PCAPNewResponse](), error) POST/accounts/{account\_id}/pcaps ##### [Stop full PCAP](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/methods/stop) client.MagicTransit.PCAPs.Stop(ctx, pcapID, body) error PUT/accounts/{account\_id}/pcaps/{pcap\_id}/stop ##### ModelsExpand Collapse
type PCAP struct{…} ID stringOptional The ID for the packet capture. maxLength32 minLength32 Link to this property FilterV1 PCAPFilterOptional The packet capture filter. When this field is empty, all packets are captured. Link to this property OffsetTime TimeOptional The RFC 3339 offset timestamp from which to query backwards for packets. Must be within the last 24h. When this field is empty, defaults to time of request. formatdate-time Link to this property
Status PCAPStatusOptional The status of the packet capture request. One of the following: const PCAPStatusUnknown PCAPStatus = "unknown" Link to this property const PCAPStatusSuccess PCAPStatus = "success" Link to this property const PCAPStatusPending PCAPStatus = "pending" Link to this property const PCAPStatusRunning PCAPStatus = "running" Link to this property const PCAPStatusConversionPending PCAPStatus = "conversion\_pending" Link to this property const PCAPStatusConversionRunning PCAPStatus = "conversion\_running" Link to this property const PCAPStatusComplete PCAPStatus = "complete" Link to this property const PCAPStatusFailed PCAPStatus = "failed" Link to this property
Link to this property Submitted stringOptional The RFC 3339 timestamp when the packet capture was created. Link to this property System PCAPSystemOptional The system used to collect packet captures. Link to this property TimeLimit float64Optional The packet capture duration in seconds. maximum300 minimum1 Link to this property
Type PCAPTypeOptional The type of packet capture. Simple captures sampled packets, and full captures entire payloads and non-sampled packets. One of the following: const PCAPTypeSimple PCAPType = "simple" Link to this property const PCAPTypeFull PCAPType = "full" Link to this property
Link to this property
[Link to this property](<#(resource)%20magic_transit.pcaps%20%3E%20(model)%20pcap%20%3E%20(schema)>)
type PCAPFilter struct{…} The packet capture filter. When this field is empty, all packets are captured. DestinationAddress stringOptional The destination IP address of the packet. Link to this property DestinationPort float64Optional The destination port of the packet. Link to this property Protocol float64Optional The protocol number of the packet. Link to this property SourceAddress stringOptional The source IP address of the packet. Link to this property SourcePort float64Optional The source port of the packet. Link to this property
[Link to this property](<#(resource)%20magic_transit.pcaps%20%3E%20(model)%20pcap_filter%20%3E%20(schema)>) #### PCAPsOwnership ##### [List PCAPs Bucket Ownership](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/subresources/ownership/methods/get) client.MagicTransit.PCAPs.Ownership.Get(ctx, query) (\*SinglePage\[[Ownership]()], error) GET/accounts/{account\_id}/pcaps/ownership ##### [Add buckets for full packet captures](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/subresources/ownership/methods/create) client.MagicTransit.PCAPs.Ownership.New(ctx, params) (\*[Ownership](), error) POST/accounts/{account\_id}/pcaps/ownership ##### [Delete buckets for full packet captures](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/subresources/ownership/methods/delete) client.MagicTransit.PCAPs.Ownership.Delete(ctx, ownershipID, body) error DELETE/accounts/{account\_id}/pcaps/ownership/{ownership\_id} ##### [Validate buckets for full packet captures](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/subresources/ownership/methods/validate) client.MagicTransit.PCAPs.Ownership.Validate(ctx, params) (\*[Ownership](), error) POST/accounts/{account\_id}/pcaps/ownership/validate ##### ModelsExpand Collapse
type Ownership struct{…} ID string The bucket ID associated with the packet captures API. maxLength32 minLength32 Link to this property DestinationConf string The full URI for the bucket. This field only applies to full packet captures. Link to this property Filename string The ownership challenge filename stored in the bucket. Link to this property
Status OwnershipStatus The status of the ownership challenge. Can be pending, success or failed. One of the following: const OwnershipStatusPending OwnershipStatus = "pending" Link to this property const OwnershipStatusSuccess OwnershipStatus = "success" Link to this property const OwnershipStatusFailed OwnershipStatus = "failed" Link to this property
Link to this property Submitted string The RFC 3339 timestamp when the bucket was added to packet captures API. Link to this property Validated stringOptional The RFC 3339 timestamp when the bucket was validated. Link to this property
[Link to this property](<#(resource)%20magic_transit.pcaps.ownership%20%3E%20(model)%20ownership%20%3E%20(schema)>) #### PCAPsDownload ##### [Download Simple PCAP](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/pcaps/subresources/download/methods/get) client.MagicTransit.PCAPs.Download.Get(ctx, pcapID, query) (\*Response, error) GET/accounts/{account\_id}/pcaps/{pcap\_id}/download