LogoLogo
StatusChangelogDashboardCreate a Ticket
  • Getting Started
  • Intro to APIs
  • How to Contact us
  • How to Go-Live
  • Intro to Risk
  • Intro to Spec Sheets
  • Product Guides
    • Deposit Hub
      • 🌎Global Cash
    • Credit Hub
    • Payment Accounts
    • ID Score
  • API References
    • OAuth
      • OAuth Object Details
      • Create OAuth Key
      • Generate Refresh Token
    • Users
      • User Object Details
      • Testing on UAT
      • View All Users
      • View User
      • Create User
      • Update User
      • Generate UBO Doc
      • Manage Duplicates
      • Allowed Document Types
      • Allowed Entity Scopes
      • Allowed Entity Types
    • Nodes
      • Node Object Details
      • Testing on UAT
      • View all User Nodes
      • View Node
      • Create Node
      • Update Node
      • Generate eCash Barcode
      • Allowed Node Types
      • View ATMs
    • Subnets
      • Subnet Object Details
      • Testing on UAT
      • View all Node Subnets
      • View Subnet
      • Create Subnet
      • Update Subnet
      • Push to Wallet
    • Shipments
      • Shipment Object Details
      • View all Subnet Shipments
      • View Shipment
      • Create Shipment
      • Cancel Shipment
    • Statements
      • Statement Object Details
      • View all User Statements
      • View all Node Statements
    • Transactions
      • Transaction Object Details
      • Testing on UAT
      • View all User Transactions
      • View all Node Transactions
      • View Transaction
      • Create Transaction
      • Create Batch Transactions
      • Cancel Transaction
      • Retry ACH Transaction
      • Dispute Chargebacks
      • Dispute Transaction
    • Subscriptions
      • Subscription Object Details
      • Webhook Object Details
      • Testing on UAT
      • View all Subscriptions
      • View Subscription
      • Create Subscription
      • Update Subscription
      • View Webhook Logs
    • Miscellaneous
      • Dummy Transactions
      • Verify Address
      • Verify Routing Number
      • International WIRE-INT Required Data by Country
      • View Billers
      • View Enriched Data
      • Loan Limits
      • Transaction Decisioning
      • 3D Secure
      • Virtual Terminal
      • Pre-Authorization
      • Card Disputes Guide
      • Mobile Wallets
      • Interchange Revenue
      • Enrichment Guide
  • Developer Guides
    • User Onboarding
      • Create User Flow
      • Authenticate as the User
      • Create Node Flow
        • Cash Advance
        • Credit Builder Loan
        • One Time Loans
        • Secured Open Loans
        • Secured Revolving Loans
        • Unsecured Revolving Loans
      • Create Subnets Flow
        • Creating Cards
        • Creating AC/RT
      • Linking External Accounts
        • Linking Cards
        • Linking External Bank Account
      • Add Additional Documents
    • Account Details
      • Displaying Balances
      • Transaction History
      • Transaction Details
      • Account Agreements
      • Node Statements
      • Card Details
    • Managing Cards
      • Card Preferences
      • Setting PIN
      • Mobile Wallet Flow
        • Integrate with Apple Pay
        • Integrate with Google Pay
        • Integrate with Samsung Pay
      • Shipping Cards
    • Originating Transactions
      • Sending Fed Wires
      • Sending ACH Transfers
      • Sending International Wires
      • Deposit a Check
      • Issuing Checks
      • Recurring Transactions
      • 3rd Party Payment Accounts
      • Cancelling Transactions
      • Exceeding Origination Limits
    • Receiving Transactions
      • Transaction Decisioning
      • Receiving ACH / Wires
      • Card Transactions
      • Exceeding Inbound Limits
    • Managing Disputes
      • ACH Disputes
      • Card Disputes
    • 3rd Party Integrations
      • Payment Integrations
      • Account Aggregators
      • 3rd Parties & Compliance
  • Recipes
    • Overdraft Protection
    • Social Banking
    • Monetizing Transactions
Powered by GitBook
On this page
  • User
  • Example Request

Was this helpful?

Export as PDF
  1. API References
  2. Users

View User

User

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

This endpoint allows you to get a specific user document.

Path Parameters

Name
Type
Description

user_id

string

ID of the user to get.

Query Parameters

Name
Type
Description

full_dehydrate

string

Set to YES if you wish to receive all user PII in the response. Default is NO.

Headers

Name
Type
Description

X-SP-USER

string

Your OAuth key and device fingerprint, separated by a pipe. For this request OAuth can be left blank since X-SP-GATEWAY will be used for authentication. But device fingerprint is still required.

X-SP-USER-IP

string

IP address of your device.

X-SP-GATEWAY

string

Your Client ID and Secret, separated by a pipe.

{
    "_id": "5ecfb7b5f8db9323b12cfa46",
    "_links": {
        "self": {
            "href": "https://uat-api.synapsefi.com/v3.1/users/5ecfb7b5f8db9323b12cfa46"
        }
    },
    "account_closure_date": null,
    "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFi"
    },
    "documents": [
        {
            "entity_scope": "Arts & Entertainment",
            "entity_type": "M",
            "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
            "id_score": 1.0,
            "is_active": true,
            "name": "Test User",
            "permission_scope": "SEND|RECEIVE",
            "physical_docs": [
                {
                    "document_type": "GOVT_ID",
                    "id": "38dd7abbefd347315bebeaeb3a6f210e506066abc27b36c87dde060e9baf7c3d",
                    "last_updated": 1590671292685,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "GOVT_ID_BACK",
                    "id": "f2296315e36857799e5c7f5d85b33e554fa3fc9074ca85dbf04cef9b70bcfb7e",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED"
                }
            ],
            "required_edd_docs": [],
            "social_docs": [
                {
                    "document_type": "EMAIL",
                    "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "IP",
                    "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "ADDRESS",
                    "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED"
                },
                {
                    "document_type": "PHONE_NUMBER",
                    "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "DATE",
                    "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED"
                }
            ],
            "virtual_docs": [
                {
                    "document_type": "SSN",
                    "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
                    "last_updated": 1590671292685,
                    "status": "SUBMITTED|VALID"
                }
            ],
            "watchlists": "NO_MATCH"
        }
    ],
    "emails": [],
    "extra": {
        "cip_tag": 1,
        "date_joined": 1590671281454,
        "extra_security": false,
        "is_business": false,
        "is_trusted": false,
        "last_updated": 1590671292335,
        "public_note": null,
        "supp_id": "122eddfgbeafrfvbbb"
    },
    "flag": "NOT-FLAGGED",
    "flag_code": null,
    "is_hidden": false,
    "legal_names": [
        "Test User"
    ],
    "logins": [
        {
            "email": "test@synapsepay.com",
            "scope": "READ_AND_WRITE"
        }
    ],
    "permission": "SEND-AND-RECEIVE",
    "permission_code": null,
    "phone_numbers": [
        "901.111.1111"
    ],
    "photos": [],
    "refresh_token": "refresh_sXEqp57kSz6uMvVDUmho1KlJRdAbrYCG2WP9f8g4",
    "watchlists": "NO_MATCH"
}
{
    "_id": "5ecfb7b5f8db9323b12cfa46",
    "_links": {
        "self": {
            "href": "https://uat-api.synapsefi.com/v3.1/users/5ecfb7b5f8db9323b12cfa46"
        }
    },
    "_v": 2,
    "account_closure_date": null,
    "client": {
        "id": "589acd9ecb3cd400fa75ac06",
        "name": "SynapseFi"
    },
    "documents": [
        {
            "address_city": "SAN FRANCISCO",
            "address_country_code": "US",
            "address_postal_code": "94105",
            "address_street": "1 MARKET ST",
            "address_subdivision": "CA",
            "alias": "Test",
            "day": 2,
            "desired_scope": null,
            "doc_option_key": null,
            "docs_key": null,
            "docs_title": null,
            "email": "test@test.com",
            "entity_scope": "Arts & Entertainment",
            "entity_type": "M",
            "id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
            "id_score": 1.0,
            "ip": "::1",
            "is_active": true,
            "month": 5,
            "name": "Test User",
            "permission_scope": "SEND|RECEIVE",
            "phone_number": "901.111.1111",
            "physical_docs": [
                {
                    "document_type": "GOVT_ID",
                    "document_value": "https://uat-files.synapsefi.com/5ed1953334ac7a6aea8adbc8",
                    "id": "38dd7abbefd347315bebeaeb3a6f210e506066abc27b36c87dde060e9baf7c3d",
                    "last_updated": 1590671292685,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "GOVT_ID_BACK",
                    "document_value": "https://uat-files.synapsefi.com/5ed19533043279ca1ad1e6d9",
                    "id": "f2296315e36857799e5c7f5d85b33e554fa3fc9074ca85dbf04cef9b70bcfb7e",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED"
                }
            ],
            "required_edd_docs": [],
            "screening_results": {
                "561": "NO_MATCH",
                "aucl": "NO_MATCH",
                "concern_location": "NO_MATCH",
                "dpl": "NO_MATCH",
                "dtc": "NO_MATCH",
                "el": "NO_MATCH",
                "eucl": "NO_MATCH",
                "fatf_non_cooperative_jurisdiction": "NO_MATCH",
                "fbi_bank_robbers": "NO_MATCH",
                "fbi_counter_intelligence": "NO_MATCH",
                "fbi_crimes_against_children": "NO_MATCH",
                "fbi_criminal_enterprise_investigations": "NO_MATCH",
                "fbi_cyber": "NO_MATCH",
                "fbi_domestic_terrorism": "NO_MATCH",
                "fbi_human_trafficking": "NO_MATCH",
                "fbi_murders": "NO_MATCH",
                "fbi_violent_crimes": "NO_MATCH",
                "fbi_wanted_terrorists": "NO_MATCH",
                "fbi_white_collar": "NO_MATCH",
                "fincen_red_list": "NO_MATCH",
                "fse": "NO_MATCH",
                "fto_sanctions": "NO_MATCH",
                "futures_sanctions": "NO_MATCH",
                "hkma_sanctions": "NO_MATCH",
                "hm_treasury_sanctions": "NO_MATCH",
                "isn": "NO_MATCH",
                "mas_sanctions": "NO_MATCH",
                "monitored_location": "NO_MATCH",
                "ns-isa": "NO_MATCH",
                "ofac_561_list": "NO_MATCH",
                "ofac_eo13645": "NO_MATCH",
                "ofac_fse": "NO_MATCH",
                "ofac_fse_ir": "NO_MATCH",
                "ofac_fse_sy": "NO_MATCH",
                "ofac_isa": "NO_MATCH",
                "ofac_ns_isa": "NO_MATCH",
                "ofac_plc": "NO_MATCH",
                "ofac_sdn": "NO_MATCH",
                "ofac_ssi": "NO_MATCH",
                "ofac_syria": "NO_MATCH",
                "ofac_ukraine_eo13662": "NO_MATCH",
                "osfi": "NO_MATCH",
                "pep": "NO_MATCH",
                "plc": "NO_MATCH",
                "primary_concern": "NO_MATCH",
                "sdn": "NO_MATCH",
                "ssi": "NO_MATCH",
                "tel_sanctions": "NO_MATCH",
                "ukcl": "NO_MATCH",
                "uvl": "NO_MATCH"
            },
            "social_docs": [
                {
                    "document_type": "EMAIL",
                    "document_value": "test@test.com",
                    "id": "2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "IP",
                    "document_value": "::1",
                    "id": "28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "ADDRESS",
                    "document_value": "1 Market St., SF, CA, US, 94105.",
                    "id": "c615c761d68c578a98fde8e73c490df405ff5d5e34fc11f029660d7e9743df21",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED"
                },
                {
                    "document_type": "PHONE_NUMBER",
                    "document_value": "901.111.1111",
                    "id": "fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED|VALID"
                },
                {
                    "document_type": "DATE",
                    "document_value": "5/2/1989",
                    "id": "2b52edae636ca2fbe12ab1b08a344d381dabc3d2b92844cf7a8d8b6052b26d8e",
                    "last_updated": 1590671292686,
                    "status": "SUBMITTED"
                }
            ],
            "virtual_docs": [
                {
                    "document_type": "SSN",
                    "document_value": "2222",
                    "id": "ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f",
                    "last_updated": 1590671292685,
                    "status": "SUBMITTED|VALID"
                }
            ],
            "watchlists": "NO_MATCH",
            "year": 1989
        }
    ],
    "emails": [],
    "extra": {
        "cip_tag": 1,
        "date_joined": 1590671281454,
        "extra_security": false,
        "is_business": false,
        "is_trusted": false,
        "last_updated": 1590671292335,
        "note": null,
        "public_note": null,
        "supp_id": "122eddfgbeafrfvbbb"
    },
    "flag": "NOT-FLAGGED",
    "flag_code": null,
    "ips": [
        "255.127.79.76"
    ],
    "is_hidden": false,
    "legal_names": [
        "Test User"
    ],
    "logins": [
        {
            "email": "test@synapsepay.com",
            "old_passwords": [],
            "scope": "READ_AND_WRITE",
            "updated_on": {
                "$date": 1590671292575
            }
        }
    ],
    "permission": "SEND-AND-RECEIVE",
    "permission_code": null,
    "phone_numbers": [
        "901.111.1111"
    ],
    "photos": [],
    "refresh_token": "refresh_sXEqp57kSz6uMvVDUmho1KlJRdAbrYCG2WP9f8g4",
    "watchlists": "NO_MATCH"
}
{
    "error": {
        "code": "missing_user_ip",
        "en": "User IP is missing from the request."
    },
    "error_code": "200",
    "http_code": "400",
    "success": false
}

Example Request

GET /v3.1/users/5fd7acfd8677040053ad486d?full_dehydrate=yes HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
X-SP-USER-IP: 255.127.79.76
X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json
curl --location --request GET 'https://uat-api.synapsefi.com/v3.1/users/5fd7acfd8677040053ad486d?full_dehydrate=yes' \
--header 'X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW' \
--header 'X-SP-USER-IP: 255.127.79.76' \
--header 'X-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc' \
--header 'Content-Type: application/json'
//
//
//
//
PreviousView All UsersNextCreate User

Last updated 4 years ago

Was this helpful?