How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Soracom VirtualPrivateGateway API

- [Virtual Private Gateway (VPG)](/en/docs/vpg/) (Canal / Direct / Door / Gate)- [Soracom Junction](/en/docs/junction/)- [Soracom Peek](/en/docs/peek/)

Soracom VirtualPrivateGateway API is one of 45 APIs that Soracom publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include VirtualPrivateGateway. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 4 JSON Schemas.

This API exposes 45 operations across 37 paths, and defines 50 schemas. It is described by OpenAPI 3.2.0, at version 20250903-043502.

Requests are made against 2 base URLs: https://api.soracom.io/v1, https://g.api.soracom.io/v1.

45 operations 37 paths 50 schemas 10 DELETE6 GET25 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
20250903-043502
Base URL
https://api.soracom.io/v1
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Soracom VirtualPrivateGateway API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-Soracom-API-Key (api_key). An API key is passed in the header as X-Soracom-Token (api_token).

  • api_key — API key for authentication. Obtain this from the Soracom User Console or via the Auth API. Required in combination with an API token for all authenticated requ…
  • api_token — API token for authentication. This token has an expiration time and must be refreshed periodically. Required in combination with an API key for all authenticat…

Paths & Operations 45

Across 37 paths, the API surfaces 45 operations — 10 DELETE, 6 GET, 25 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

VirtualPrivateGateway 45

- [Virtual Private Gateway (VPG)](/en/docs/vpg/) (Canal / Direct / Door / Gate) - [Soracom Junction](/en/docs/junction/) - [Soracom Peek](/en/docs/peek/)

GET
/virtual_private_gateways
List Virtual Private Gateways
listVirtualPrivateGateways 5 params → 200
POST
/virtual_private_gateways
Create Virtual Private Gateway
createVirtualPrivateGateway body → 201
GET
/virtual_private_gateways/{vpg_id}
Get Virtual Private Gateway
getVirtualPrivateGateway 1 param → 200404
POST
/virtual_private_gateways/{vpg_id}/customer_routes
Create routing table entry
createCustomerRoute 1 param body → 201400404
DELETE
/virtual_private_gateways/{vpg_id}/customer_routes/{route_id}
Delete routing table entry
deleteCustomerRoute 2 params → 204404
PUT
/virtual_private_gateways/{vpg_id}/customer_routes/{route_id}
Update routing table entry
updateCustomerRoute 2 params body → 200400404
DELETE
/virtual_private_gateways/{vpg_id}/fixed_public_ip_addresses
Disable the fixed global IP address option for the VPG
releaseFixedPublicIpAddresses 1 param → 200400404
POST
/virtual_private_gateways/{vpg_id}/fixed_public_ip_addresses
Enable the fixed global IP address option for the VPG
assignFixedPublicIpAddresses 1 param → 200400404
POST
/virtual_private_gateways/{vpg_id}/gate/close
Close SORACOM Gate.
closeGate 1 param → 200400404
POST
/virtual_private_gateways/{vpg_id}/gate/disable_privacy_separator
Disables Soracom Gate's privacy separator feature on the specified VPG
disableGatePrivacySeparator 1 param → 200404
POST
/virtual_private_gateways/{vpg_id}/gate/enable_privacy_separator
Enables Soracom Gate privacy separator feature on the specified VPG
enableGatePrivacySeparator 1 param → 200404
POST
/virtual_private_gateways/{vpg_id}/gate/open
Open Soracom Gate
openGate 1 param body → 200400404
GET
/virtual_private_gateways/{vpg_id}/gate/peers
List VPG Gate Peers
listGatePeers 1 param → 200400404
POST
/virtual_private_gateways/{vpg_id}/gate/peers
Register VPG Gate Peer
registerGatePeer 1 param body → 200400404
DELETE
/virtual_private_gateways/{vpg_id}/gate/peers/{outer_ip_address}
Unregister VPG Gate Peer
unregisterGatePeer 2 params → 204400404
POST
/virtual_private_gateways/{vpg_id}/gate/routing/static/sims/disable
Disable SIM-Based Routing
disableSimBasedRouting 1 param → 204404
POST
/virtual_private_gateways/{vpg_id}/gate/routing/static/sims/enable
Enable SIM-Based Routing
enableSimBasedRouting 1 param → 201400404
PUT
/virtual_private_gateways/{vpg_id}/gate/routing/static/sims/routes
Associate a router's LAN IP address range with its SIM ID
putSimBasedRoutingRoutes 1 param body → 200400404
POST
/virtual_private_gateways/{vpg_id}/gate/set_vxlan_id
Set VXLAN ID for Gate
setVirtualPrivateGatewayVxLanId 1 param body → 204404
GET
/virtual_private_gateways/{vpg_id}/ip_address_map
List VPG IP address map entries
listVirtualPrivateGatewayIpAddressMapEntries 3 params → 200400404
POST
/virtual_private_gateways/{vpg_id}/ip_address_map
Adds or updates an entry in VPG IP address map
putVirtualPrivateGatewayIpAddressMapEntry 1 param body → 200400404
DELETE
/virtual_private_gateways/{vpg_id}/ip_address_map/{key}
Delete VPG IP address map entry
deleteVirtualPrivateGatewayIpAddressMapEntry 2 params → 204400404
POST
/virtual_private_gateways/{vpg_id}/junction/mirroring/peers
Adds node in the list of Junction mirroring peers
createMirroringPeer 1 param body → 201404
DELETE
/virtual_private_gateways/{vpg_id}/junction/mirroring/peers/{ipaddr}
Remove peer from the list of Junction mirroring peers
deleteMirroringPeer 2 params → 204404
PUT
/virtual_private_gateways/{vpg_id}/junction/mirroring/peers/{ipaddr}
Updates a Junction mirroring peer
updateMirroringPeer 2 params body → 200404
POST
/virtual_private_gateways/{vpg_id}/junction/set_inspection
Sets configuration for Junction inspection feature
setInspectionConfiguration 1 param body → 200404
POST
/virtual_private_gateways/{vpg_id}/junction/set_redirection
Sets configuration for Junction redirection feature
setRedirectionConfiguration 1 param body → 200404
POST
/virtual_private_gateways/{vpg_id}/junction/unset_inspection
Unset configuration for Junction inspection feature
unsetInspectionConfiguration 1 param → 200404
POST
/virtual_private_gateways/{vpg_id}/junction/unset_redirection
Unset configuration for Junction redirection feature
unsetRedirectionConfiguration 1 param → 200404
GET
/virtual_private_gateways/{vpg_id}/packet_capture_sessions
List Packet Capture Sessions associated with the VPG
listPacketCaptureSessions 3 params → 200400404
POST
/virtual_private_gateways/{vpg_id}/packet_capture_sessions
Create a packet capture session associated with the VPG
createPacketCaptureSession 1 param body → 200400404
DELETE
/virtual_private_gateways/{vpg_id}/packet_capture_sessions/{session_id}
Delete a packet capture session associated with the VPG
deletePacketCaptureSession 2 params → 200400404
GET
/virtual_private_gateways/{vpg_id}/packet_capture_sessions/{session_id}
Get a packet capture session associated with the VPG
getPacketCaptureSession 2 params → 200404
POST
/virtual_private_gateways/{vpg_id}/packet_capture_sessions/{session_id}/stop
Stop a packet capture session associated with the VPG
stopPacketCaptureSession 2 params → 200400404500
POST
/virtual_private_gateways/{vpg_id}/set_routing_filter
Sets Virtual Private Gateway outbound routing filter
setRoutingFilter 1 param body → 200400404
PUT
/virtual_private_gateways/{vpg_id}/tags
Update VPG tags
updateVirtualPrivateGatewayTags 1 param body → 204404
DELETE
/virtual_private_gateways/{vpg_id}/tags/{tag_name}
Delete a VPG Tag
deleteVirtualPrivateGatewayTag 2 params → 204404
POST
/virtual_private_gateways/{vpg_id}/terminate
Terminate Virtual Private Gateway
terminateVirtualPrivateGateway 1 param → 200400404
POST
/virtual_private_gateways/{vpg_id}/transit_gateway_peering_connections
Create transit gateway peering connection
createTransitGatewayPeeringConnection 1 param body → 201400404
DELETE
/virtual_private_gateways/{vpg_id}/transit_gateway_peering_connections/{soracom_tgw_peering_attachment_id}
Delete transit gateway peering connection
deleteTransitGatewayPeeringConnection 2 params → 204404
POST
/virtual_private_gateways/{vpg_id}/transit_gateway_vpc_attachments
Create transit gateway VPC attachment
createTransitGatewayVpcAttachment 1 param body → 201400404
DELETE
/virtual_private_gateways/{vpg_id}/transit_gateway_vpc_attachments/{customer_tgw_vpc_attachment_id}
Delete transit gateway VPC attachment
deleteTransitGatewayVpcAttachment 2 params → 204404
POST
/virtual_private_gateways/{vpg_id}/transit_gateway_vpc_attachments/{customer_tgw_vpc_attachment_id}/accept
Accept transit gateway VPC attachment connection request
acceptTransitGatewayVpcAttachmentFromCustomer 2 params → 202400404
POST
/virtual_private_gateways/{vpg_id}/vpc_peering_connections
Create VPC Peering Connection
createVpcPeeringConnection 1 param body → 201404
DELETE
/virtual_private_gateways/{vpg_id}/vpc_peering_connections/{pcx_id}
Delete VPC Peering Connection
deleteVpcPeeringConnection 2 params → 204404

Schemas 50

The contract defines 50 schemas that model the data the API accepts and returns. The most detailed are VirtualPrivateGateway (38 properties), TransitGatewayPeeringConnection (9 properties), PacketCaptureSession (9 properties), TransitGatewayVpcAttachment (8 properties). Each schema is shown below with its type and property counts.

SoracomTransitGateway
object
6 properties
FunnelEsrijArcgisOnlineDestination
object
4 properties
PacketCaptureSession
object
9 properties
Placement
object
2 properties
FunnelInfoteriaPlatioDestination
object
7 properties
CreateVpcPeeringConnectionRequest
object
4 properties
TagSet
object
An object which always contains at least one property "name" with a string value. If you give a subscriber/SIM a name, the name will be returned as the value o…
TransitGatewayResourceSharedStatus
object
5 properties
TransitGatewayVpcAttachment
object
8 properties
JunctionRedirectionConfiguration
object
3 properties
JunctionMirroringPeer
object
4 properties
VpnConnection
object
3 properties
CreateVirtualPrivateGatewayRequest
object
6 properties 1 required
CustomerRoute
object
4 properties
FunnelGooglePubSubDestination
object
4 properties
FunnelAWSKinesisDestination
object
5 properties
FunnelLandlogDestination
object
5 properties
CreateCustomerRouteRequest
object
4 properties 2 required
FunnelWingarcMotionboardDestination
object
3 properties
FunnelConfiguration
object
5 properties
FunnelAcroquestTorrentioDestination
object
5 properties
SetVirtualPrivateGatewayVxLanIdRequest
object
1 property 1 required
FunnelBrainsTechImpulseDestination
object
3 properties
FunnelAWSIoTDestination
object
5 properties
RegisterGatePeerRequest
object
2 properties 1 required
AttributeUpdate
object
2 properties
FunnelDestination
object
3 properties
UpdateCustomerRouteRequest
object
1 property 1 required
FunnelYaskawaMmcloudDestination
object
5 properties
RoutingFilterEntry
object
2 properties 2 required
JunctionInspectionConfiguration
object
2 properties
CreateTransitGatewayVpcAttachmentRequest
object
3 properties 2 required
CreateTransitGatewayPeeringConnectionRequest
object
4 properties 3 required
FunnelAzureEventHubDestination
object
4 properties
TransitGatewayAttachment
object
3 properties
FunnelContentType
string
FunnelKiiThingifDestination
object
3 properties
GatePeer
object
4 properties
FunnelOptimCloudiotosDestination
object
5 properties
FunnelSensorCorpusDestination
object
4 properties
PutSimBasedRoutingRoutesRequest
object
Association a router's LAN IP address range and its SIM ID.
IpAddressMapEntry
object
5 properties 4 required
PutIpAddressMapEntryRequest
object
2 properties 2 required
FunnelTeradataIntellicloudDestination
object
3 properties
VirtualPrivateGateway
object
38 properties
TransitGatewayPeeringConnection
object
9 properties
UpdateVirtualPrivateGatewayTagsRequest
array
PacketCaptureSessionRequest
object
2 properties 1 required
FunnelAWSFirehoseDestination
object
4 properties
OpenGateRequest
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

soracom-virtualprivategateway-api-openapi.yml Raw ↑

Other APIs Soracom publishes across the network.

Soracom SIM Management API
Soracom Group Configuration API
Soracom Billing API
Soracom Stats and Diagnostics API
Soracom Auth and Access Management API
Soracom Lagoon API
Soracom Cloud Camera Services API
Soracom Batch API
Soracom Analysis API
Soracom API Sandbox: Coupon API
Soracom API Sandbox: Operator API
Soracom API Sandbox: Order API
Where this information came from

This is an independent, third-party profile of Soracom VirtualPrivateGateway API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.