View all Node Subnets

Get Subnets

GET https://api.synapsefi.com/v3.1/users/:user_id/nodes/:node_id/subnets

This endpoint allows you to get all subnets linked to a node.

Path Parameters

Name	Type	Description
user_id	string	ID of the user.
	string	ID of the node.

Query Parameters

Name	Type	Description
per_page	integer	Maximum documents to return per page. Default and max allowed is 20.
page	integer	Page number of the paginated request. Default is 1.

Headers

Name	Type	Description
X-SP-USER	string	User's OAuth key and device fingerprint, separated by a pipe.
X-SP-USER-IP	string	IP address of user's device.
X-SP-GATEWAY	string	Your Client ID and Secret, separated by a pipe.

200 Users successfully retrieved.

{
    "error_code": "0",
    "http_code": "200",
    "limit": 20,
    "page": 1,
    "page_count": 1,
    "subnets": [
        {
            "_id": "5fdaa7d56387987e63f30d9e",
            "_links": {
                "self": {
                    "href": "https://uat-api.synapsefi.com/v3.1/users/5fd7acfd8677040053ad486d/nodes/5fd901bb20b3aa0bc7caee85/subnets/5fdaa7d56387987e63f30d9e"
                }
            },
            "abu_token": "5fdaa7d6e4428eb1b8b13c25",
            "account_class": "CARD",
            "agreements": [
                {
                    "type": "SUBNET_AGREEMENT",
                    "url": "https://cdn.synapsepay.com/uploads/2020/12/17/dF2fpTiX1uq9bOmVSYw3HM6NgeorP4zkUZA0JE7hQay08GLWIl.pdf"
                }
            ],
            "card_number": "6707",
            "card_style_id": null,
            "client": {
                "id": "589acd9ecb3cd400fa75ac06",
                "name": "SynapseFi"
            },
            "created_on": 1608165332508,
            "cvc": "***",
            "exp": "2024-12-16",
            "nickname": "My Debit Card",
            "node_id": "5fd901bb20b3aa0bc7caee85",
            "preferences": {
                "allow_cash_transactions": true,
                "allow_foreign_transactions": false,
                "daily_cash_limit": 100.0,
                "daily_transaction_limit": 1000.0
            },
            "status": "INACTIVE",
            "status_code": "USER_REQUESTED",
            "supp_id": null,
            "updated_on": 1608165334534,
            "user_id": "5fd7acfd8677040053ad486d"
        },
        {
            ...
        }
    ],
    "subnets_count": 2,
    "success": true
}

400 Query failing

{
    "error": {
        "code": "missing_user_credentials",
        "en": "User credentials are missing from the request."
    },
    "error_code": "200",
    "http_code": "400",
    "success": false
}

Example Request

HTTP

GET /v3.1/users/5fd7acfd8677040053ad486d/nodes/5bc0c76f4ca8c400aa8d4cbc/subnets HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_0YFNLHvg2c0mjGopszQ45yOBiqSUl8xruCRfaZXw|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json

cURL

curl --location --request GET 'https://uat-api.synapsefi.com/v3.1/users/5fd7acfd8677040053ad486d/nodes/5bc0c76f4ca8c400aa8d4cbc/subnets' \
--header 'X-SP-USER-IP: 255.127.79.76' \
--header 'X-SP-USER: oauth_0YFNLHvg2c0mjGopszQ45yOBiqSUl8xruCRfaZXw|e83cf6ddcf778e37bfe3d48fc78a6502062fc' \
--header 'Content-Type: application/json'

Python

//

JS

//

PHP

//

GO

//