Skip to main content
GET
/
v2
/
partner
/
clients
/
{client_id}
/
nexus
Get Partner Client Nexus Detail
curl --request GET \
  --url https://api.trykintsugi.com/v2/partner/clients/{client_id}/nexus \
  --header 'X-API-KEY: <api-key>'
{
  "items": [
    {
      "state_code": "<string>",
      "state_name": "<string>",
      "trigger": "<string>",
      "threshold_transactions": 123,
      "start_date": "2023-12-25",
      "period_start_date": "2023-12-25",
      "period_end_date": "2023-12-25",
      "previous_period_start_date": "2023-12-25",
      "previous_period_end_date": "2023-12-25",
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "organization_id": "<string>",
      "threshold_sales": 123,
      "is_vda_eligible": true,
      "total_transactions": 123,
      "total_transactions_included": 123,
      "total_transactions_exempted": 123,
      "total_transactions_marketplace": 123,
      "marketplace_included": true,
      "processing_status": "UP_TO_DATE",
      "status": "NOT_EXPOSED",
      "threshold_sales_bigint": 0,
      "transaction_count": 0,
      "transactions_amount": "0.00",
      "previous_transaction_count": 0,
      "previous_transactions_amount": "0.00",
      "calculated_tax_liability": "0.00",
      "imported_tax_liability": "0.00",
      "tax_liability": "0.00",
      "nexus_met": false,
      "nexus_met_date": "2023-12-25",
      "economic_nexus_met": false,
      "economic_nexus_met_date": "2023-12-25",
      "physical_nexus_met": false,
      "physical_nexus_met_date": "2023-12-25",
      "collected_tax_nexus_met": false,
      "collected_tax_nexus_met_date": "2023-12-25",
      "earliest_transaction_date": "2023-11-07T05:31:56Z",
      "most_recent_transaction_date": "2023-11-07T05:31:56Z",
      "find_threshold_crossing_transaction_state": {
        "period_start_date": "<string>",
        "period_end_date": "<string>",
        "running_sales_total_decimal": "<string>",
        "running_transaction_count": 123,
        "has_all_marketplace_transactions": true,
        "last_txn_id": "<string>",
        "last_txn_datetime": "<string>"
      },
      "earliest_collected_date": "2018-01-01T00:00:00",
      "predicted_month_from_today": 123,
      "vda_eligible": false,
      "confidence_level": 123,
      "last_processed_at": "2023-11-07T05:31:56Z",
      "last_tax_liability_processed_at": "2023-11-07T05:31:56Z",
      "periods": [
        {}
      ],
      "registration": {},
      "disregarded_at": "2023-11-07T05:31:56Z",
      "disregarded_by": "<string>",
      "disregarded_nexus_types": [
        "<string>"
      ],
      "is_currently_disregarded": false
    }
  ],
  "total": 1,
  "page": 2,
  "size": 2,
  "pages": 1
}

Authorizations

​
X-API-KEY
string
header
required

Headers

​
x-partner-id
string | null

Target partner. Required for referral partner API keys (selects the owned sub-partner; omitting it returns 400 PARTNER_ID_REQUIRED). For multi-partner bearer users, selects the active partner.

Maximum string length: 100

Path Parameters

​
client_id
string
required

Query Parameters

​
without_pagination
boolean
default:false

Return all results without pagination (same as merchant nexus API).

​
disregard_view
string | null

Filter nexuses by disregard view: 'exposed' or 'disregarded'

​
status__in
string | null
default:APPROACHING,NOT_EXPOSED,PENDING_REGISTRATION,EXPOSED,REGISTERED
​
state_code
string | null
​
country_code__in
string | null
​
order_by
string | null
default:state_code,country_code
​
collected_tax_nexus_met
boolean | null
​
page
integer
default:1
Required range: x >= 1
​
size
integer
default:50
Required range: 1 <= x <= 100

Response

Successful Response

​
items
NexusResponse · object[]
required
​
total
integer
required
Required range: x >= 0
​
page
integer
required
Required range: x >= 1
​
size
integer
required
Required range: x >= 1
​
pages
integer
required
Required range: x >= 0