Get Physical Nexus

GET

nexus

physical_nexus

Get Physical Nexus

curl --request GET \
  --url https://api.trykintsugi.com/v1/nexus/physical_nexus \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-organization-id: <api-key>'

{
  "items": [
    {
      "country_code": "US",
      "state_code": "CA",
      "start_date": "2024-01-01",
      "category": "PHYSICAL_BUSINESS_LOCATION",
      "id": "phys_ABC123DEF456"
    },
    {
      "country_code": "US",
      "state_code": "NY",
      "start_date": "2024-03-15",
      "category": "TELECOMMUTING_OR_REMOTE_EMPLOYEE",
      "id": "phys_XYZ789GHI012"
    },
    {
      "country_code": "US",
      "state_code": "TX",
      "start_date": "2024-06-01",
      "category": "PHYSICAL_BUSINESS_LOCATION",
      "external_id": "ext_98765",
      "id": "phys_456DEF123ABC"
    },
    {
      "country_code": "US",
      "state_code": "FL",
      "start_date": "2024-07-01",
      "end_date": "2024-12-31",
      "category": "TELECOMMUTING_OR_REMOTE_EMPLOYEE",
      "external_id": "ext_54321",
      "id": "phys_321CBA654FED"
    },
    {
      "country_code": "US",
      "state_code": "WA",
      "start_date": "2024-09-01",
      "category": "PHYSICAL_BUSINESS_LOCATION",
      "id": "phys_654FED321CBA"
    }
  ],
  "total": 2,
  "page": 1,
  "size": 50,
  "pages": 1
}

Authorizations

X-API-KEY

string

header

required

x-organization-id

string

header

required

Query Parameters

country_code

string

state_code

string

order_by

string

default:country_code,state_code,start_date,end_date

page

integer

default:1

Page number

Required range: x >= 1

size

integer

default:50

Page size

Required range: 1 <= x <= 100

Response

Successfully retrieved physical nexuses

items

PhysicalNexusRead · object[]

required

Show child attributes

items.country_code

enum<string>

required

The country code in ISO 3166-1 alpha-2 format (e.g., US).

Available options:

AF,

AX,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AU,

AT,

AZ,

BS,

BH,

BD,

BB,

BY,

BE,

BZ,

BJ,

BM,

BT,

BO,

BQ,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

CV,

KH,

CM,

CA,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

HR,

CU,

CW,

CY,

CZ,

DK,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

SZ,

ET,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

DE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HK,

HU,

IS,

IN,

ID,

IR,

IQ,

IE,

IM,

IL,

IT,

CI,

JM,

JP,

JE,

JO,

KZ,

KE,

KI,

KP,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

LU,

MO,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

NL,

NC,

NZ,

NI,

NE,

NG,

NU,

NF,

MK,

MP,

NO,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

QA,

RE,

RO,

RU,

RW,

BL,

SH,

KN,

LC,

MF,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

RS,

SC,

SL,

SG,

SX,

SK,

SI,

SB,

SO,

ZA,

GS,

SS,

ES,

LK,

SD,

SR,

SJ,

SE,

CH,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

GB,

US,

UM,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW,

XK,

ZZ_EU

items.state_code

string

required

The state or province code in ISO 3166-2 format (e.g., CA).

items.start_date

string<date>

required

The date when the nexus became effective (YYYY-MM-DD).

items.category

enum<string>

required

The reason for the nexus (e.g., 'TELECOMMUTING_OR_REMOTE_EMPLOYEE').

Available options:

PHYSICAL_BUSINESS_LOCATION,

TELECOMMUTING_OR_REMOTE_EMPLOYEE,

WARRANTY_AND_REPAIR_SERVICES,

CATALOGUE_DISTRIBUTION_OR_ADVERTISING_MATERIAL,

DELIVERY_BY_COMMON_CARRIER,

DELIVERY_BY_OWN_VEHICLES,

IN_STATE_SALES_PERSON,

INDEPENDENT_CONTRACTOR_OR_THIRD_PARTY_SALES_PERSON,

WAREHOUSE_AND_INVENTORY_PRESENCE,

EMPLOYEES_AGENTS_CONTRACTORS,

OWN_LEASE_A_PROPERTY,

INVENTORY,

DELIVERY_USING_COMPANY_VEHICLES,

OWN_BUSINESS_INFRASTRUCTURE_AND_EQUIPMENT,

ON_SITE_INSTALLATION_MAINTENANCE_SERVICES,

FREQUENT_PARTICIPATION_IN_TRADE_SHOWS_EVENTS,

MANUFACTURE_OR_PRODUCTION_IN_CANADA,

PERFORMING_SERVICES_IN_THE_JURISDICTION,

MANUFACTURING_FACILITIES,

SERVERS_DATA_CENTERS,

TRADE_SHOW_PRESENCE,

TRADE_SHOW_PRESENCE_WITHOUT_SALES,

DIGITAL_INFRASTRUCTURE_LOCALIZED,

PERMANENT_ESTABLISHMENT,

ENTER_CONTRACTS_WITH_LOCALS,

CONSIGNMENT_STOCK_ARRANGEMENTS

items.id

string

required

The unique identifier for the physical nexus.

items.end_date

string

The date when the nexus ended, if applicable.

items.external_id

string

Optional external identifier for the nexus.

items.source

enum<string>

default:USER

The source of the physical nexus presence. Possible values: USER, DEEL.

Available options:

USER,

DEEL

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

Update Physical NexusThe Update Physical Nexus API allows you to modify the details of an existing physical nexus by its unique ID.

⌘I

Get Physical Nexus

curl --request GET \
  --url https://api.trykintsugi.com/v1/nexus/physical_nexus \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-organization-id: <api-key>'

{
  "items": [
    {
      "country_code": "US",
      "state_code": "CA",
      "start_date": "2024-01-01",
      "category": "PHYSICAL_BUSINESS_LOCATION",
      "id": "phys_ABC123DEF456"
    },
    {
      "country_code": "US",
      "state_code": "NY",
      "start_date": "2024-03-15",
      "category": "TELECOMMUTING_OR_REMOTE_EMPLOYEE",
      "id": "phys_XYZ789GHI012"
    },
    {
      "country_code": "US",
      "state_code": "TX",
      "start_date": "2024-06-01",
      "category": "PHYSICAL_BUSINESS_LOCATION",
      "external_id": "ext_98765",
      "id": "phys_456DEF123ABC"
    },
    {
      "country_code": "US",
      "state_code": "FL",
      "start_date": "2024-07-01",
      "end_date": "2024-12-31",
      "category": "TELECOMMUTING_OR_REMOTE_EMPLOYEE",
      "external_id": "ext_54321",
      "id": "phys_321CBA654FED"
    },
    {
      "country_code": "US",
      "state_code": "WA",
      "start_date": "2024-09-01",
      "category": "PHYSICAL_BUSINESS_LOCATION",
      "id": "phys_654FED321CBA"
    }
  ],
  "total": 2,
  "page": 1,
  "size": 50,
  "pages": 1
}

Tax Estimation

Transactions

Address Validation

Customers

Registrations

Products

Nexus

Filings

Exemptions

Get Physical Nexus

Authorizations

Query Parameters

Response