Get foreign qualification requirements
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.getpalm.com/v1/filing/foreign-qualification/requirement', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.getpalm.com/v1/filing/foreign-qualification/requirement"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.getpalm.com/v1/filing/foreign-qualification/requirement \
--header 'Authorization: Bearer <token>'{
"type": "formation",
"schema": {
"type": "object",
"required": [
"jurisdiction",
"legal_name",
"purpose",
"email",
"contact",
"principal_address",
"organizers"
],
"properties": {
"legal_name": {
"type": "string"
},
"purpose": {
"type": "string"
},
"email": {
"type": "string",
"format": "email",
"description": "Business email address"
},
"contact": {
"type": "object",
"required": [
"name",
"email"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"phone": {
"type": "string"
}
}
},
"principal_address": {
"type": "object",
"description": "Principal office address",
"required": [
"street_line_1",
"city",
"region",
"postal_code",
"country"
],
"properties": {
"street_line_1": {
"type": "string"
},
"city": {
"type": "string"
},
"region": {
"type": "string",
"description": "State or region code"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"mailing_address": {
"type": "object",
"description": "Mailing address if different from principal office",
"properties": {
"street_line_1": {
"type": "string"
},
"city": {
"type": "string"
},
"region": {
"type": "string",
"description": "State or region code"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"registered_agent": {
"type": "object",
"required": [
"type",
"name",
"address"
],
"properties": {
"type": {
"type": "string",
"enum": [
"person",
"organization"
]
},
"name": {
"type": "object",
"description": "A person or an entity. Discriminated by `type`.",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"enum": [
"person",
"entity"
]
},
"first": {
"type": "string",
"description": "Required when type is \"person\""
},
"last": {
"type": "string",
"description": "Required when type is \"person\""
},
"entity_name": {
"type": "string",
"description": "Required when type is \"entity\""
}
}
},
"address": {
"type": "object",
"description": "Registered office address (must be in the formation jurisdiction)",
"properties": {
"street_line_1": {
"type": "string"
},
"city": {
"type": "string"
},
"region": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string"
}
}
}
}
},
"organizers": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"name",
"address"
],
"properties": {
"name": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"enum": [
"person",
"entity"
]
},
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"entity_name": {
"type": "string"
}
}
},
"address": {
"type": "object",
"description": "Party address"
},
"title": {
"type": "string"
}
}
}
},
"tax_accounts": {
"type": "array",
"items": {
"type": "string",
"enum": [
"sales_tax"
]
}
},
"fein": {
"type": "string"
},
"ldr_sales_tax": {
"type": "object"
}
},
"allOf": [
{
"if": {
"properties": {
"tax_accounts": {
"contains": {
"const": "sales_tax"
}
}
},
"required": [
"tax_accounts"
]
},
"then": {
"required": [
"ldr_sales_tax",
"fein"
]
}
}
]
},
"entity_type": "llc",
"jurisdiction": "US-NC",
"expedited_tiers": [
"24_hour",
"same_day",
"1_hour"
],
"prerequisites": [
{
"type": "certificate_of_good_standing",
"description": "A certificate of existence from the home jurisdiction, dated within six months of filing.",
"required": true,
"condition": null,
"issuer": "Secretary of State of the home jurisdiction",
"max_age": {
"value": 6,
"unit": "months"
},
"accepted_formats": [
"pdf"
],
"provided_by": "palm"
}
],
"signature_requirements": [
{
"signer": "authorized_person",
"description": "Signature of an authorized person of the foreign LLC",
"cardinality": "at_least_one",
"notarized": false
}
],
"post_filing_obligations": [
{
"type": "publication",
"description": "Publish a copy of the application in two newspapers within 120 days of filing.",
"deadline": {
"value": 120,
"unit": "days",
"from": "filing"
}
}
],
"channel": "online"
}Filing
Get foreign qualification requirements
⚠️ Early access — This endpoint is in preview and may change in backwards-incompatible ways before it is marked stable. Avoid depending on it in production, and reach out before building on it.
Discover what registering an existing business in a given state needs. Call this before building a request so you know what to collect.
schema is a JSON Schema of the request body: the common fields plus the fields the state requires. Everything Palm reads from the referenced business (legal name, entity type, formation jurisdiction, formation date, registration number) is absent, since you never supply it.
prerequisites lists the documents the state needs alongside the application, each with whether it is always required and who supplies it; Palm orders the home-state certificate as part of the filing. signature_requirements lists who must sign. post_filing_obligations lists what the registration starts once accepted. channel says whether the state files online or by mail, or is null when not yet known.
expedited_tiers lists the expedited processing tiers the state offers (the accepted expedited_tier values on create); price each one with the foreign qualification fee endpoint.
Returns 501 for a state Palm does not yet support.
GET
/
v1
/
filing
/
foreign-qualification
/
requirement
Get foreign qualification requirements
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.getpalm.com/v1/filing/foreign-qualification/requirement', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.getpalm.com/v1/filing/foreign-qualification/requirement"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.getpalm.com/v1/filing/foreign-qualification/requirement \
--header 'Authorization: Bearer <token>'{
"type": "formation",
"schema": {
"type": "object",
"required": [
"jurisdiction",
"legal_name",
"purpose",
"email",
"contact",
"principal_address",
"organizers"
],
"properties": {
"legal_name": {
"type": "string"
},
"purpose": {
"type": "string"
},
"email": {
"type": "string",
"format": "email",
"description": "Business email address"
},
"contact": {
"type": "object",
"required": [
"name",
"email"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string",
"format": "email"
},
"phone": {
"type": "string"
}
}
},
"principal_address": {
"type": "object",
"description": "Principal office address",
"required": [
"street_line_1",
"city",
"region",
"postal_code",
"country"
],
"properties": {
"street_line_1": {
"type": "string"
},
"city": {
"type": "string"
},
"region": {
"type": "string",
"description": "State or region code"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"mailing_address": {
"type": "object",
"description": "Mailing address if different from principal office",
"properties": {
"street_line_1": {
"type": "string"
},
"city": {
"type": "string"
},
"region": {
"type": "string",
"description": "State or region code"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"registered_agent": {
"type": "object",
"required": [
"type",
"name",
"address"
],
"properties": {
"type": {
"type": "string",
"enum": [
"person",
"organization"
]
},
"name": {
"type": "object",
"description": "A person or an entity. Discriminated by `type`.",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"enum": [
"person",
"entity"
]
},
"first": {
"type": "string",
"description": "Required when type is \"person\""
},
"last": {
"type": "string",
"description": "Required when type is \"person\""
},
"entity_name": {
"type": "string",
"description": "Required when type is \"entity\""
}
}
},
"address": {
"type": "object",
"description": "Registered office address (must be in the formation jurisdiction)",
"properties": {
"street_line_1": {
"type": "string"
},
"city": {
"type": "string"
},
"region": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"country": {
"type": "string"
}
}
}
}
},
"organizers": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"name",
"address"
],
"properties": {
"name": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"enum": [
"person",
"entity"
]
},
"first": {
"type": "string"
},
"last": {
"type": "string"
},
"entity_name": {
"type": "string"
}
}
},
"address": {
"type": "object",
"description": "Party address"
},
"title": {
"type": "string"
}
}
}
},
"tax_accounts": {
"type": "array",
"items": {
"type": "string",
"enum": [
"sales_tax"
]
}
},
"fein": {
"type": "string"
},
"ldr_sales_tax": {
"type": "object"
}
},
"allOf": [
{
"if": {
"properties": {
"tax_accounts": {
"contains": {
"const": "sales_tax"
}
}
},
"required": [
"tax_accounts"
]
},
"then": {
"required": [
"ldr_sales_tax",
"fein"
]
}
}
]
},
"entity_type": "llc",
"jurisdiction": "US-NC",
"expedited_tiers": [
"24_hour",
"same_day",
"1_hour"
],
"prerequisites": [
{
"type": "certificate_of_good_standing",
"description": "A certificate of existence from the home jurisdiction, dated within six months of filing.",
"required": true,
"condition": null,
"issuer": "Secretary of State of the home jurisdiction",
"max_age": {
"value": 6,
"unit": "months"
},
"accepted_formats": [
"pdf"
],
"provided_by": "palm"
}
],
"signature_requirements": [
{
"signer": "authorized_person",
"description": "Signature of an authorized person of the foreign LLC",
"cardinality": "at_least_one",
"notarized": false
}
],
"post_filing_obligations": [
{
"type": "publication",
"description": "Publish a copy of the application in two newspapers within 120 days of filing.",
"deadline": {
"value": 120,
"unit": "days",
"from": "filing"
}
}
],
"channel": "online"
}Authorizations
Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx
Query Parameters
Entity type of the existing business
Available options:
llc, professional_llc, corporation, professional_corporation The state to register in (e.g., US-TX)
Response
Foreign qualification requirements
Filing type
Example:
"formation"
JSON Schema describing the request body for this filing.
Example:
{
"type": "object",
"required": [
"jurisdiction",
"legal_name",
"purpose",
"email",
"contact",
"principal_address",
"organizers"
],
"properties": {
"legal_name": { "type": "string" },
"purpose": { "type": "string" },
"email": {
"type": "string",
"format": "email",
"description": "Business email address"
},
"contact": {
"type": "object",
"required": ["name", "email"],
"properties": {
"name": { "type": "string" },
"email": { "type": "string", "format": "email" },
"phone": { "type": "string" }
}
},
"principal_address": {
"type": "object",
"description": "Principal office address",
"required": [
"street_line_1",
"city",
"region",
"postal_code",
"country"
],
"properties": {
"street_line_1": { "type": "string" },
"city": { "type": "string" },
"region": {
"type": "string",
"description": "State or region code"
},
"postal_code": { "type": "string" },
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"mailing_address": {
"type": "object",
"description": "Mailing address if different from principal office",
"properties": {
"street_line_1": { "type": "string" },
"city": { "type": "string" },
"region": {
"type": "string",
"description": "State or region code"
},
"postal_code": { "type": "string" },
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"registered_agent": {
"type": "object",
"required": ["type", "name", "address"],
"properties": {
"type": {
"type": "string",
"enum": ["person", "organization"]
},
"name": {
"type": "object",
"description": "A person or an entity. Discriminated by `type`.",
"required": ["type"],
"properties": {
"type": {
"type": "string",
"enum": ["person", "entity"]
},
"first": {
"type": "string",
"description": "Required when type is \"person\""
},
"last": {
"type": "string",
"description": "Required when type is \"person\""
},
"entity_name": {
"type": "string",
"description": "Required when type is \"entity\""
}
}
},
"address": {
"type": "object",
"description": "Registered office address (must be in the formation jurisdiction)",
"properties": {
"street_line_1": { "type": "string" },
"city": { "type": "string" },
"region": { "type": "string" },
"postal_code": { "type": "string" },
"country": { "type": "string" }
}
}
}
},
"organizers": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["name", "address"],
"properties": {
"name": {
"type": "object",
"required": ["type"],
"properties": {
"type": {
"type": "string",
"enum": ["person", "entity"]
},
"first": { "type": "string" },
"last": { "type": "string" },
"entity_name": { "type": "string" }
}
},
"address": {
"type": "object",
"description": "Party address"
},
"title": { "type": "string" }
}
}
},
"tax_accounts": {
"type": "array",
"items": { "type": "string", "enum": ["sales_tax"] }
},
"fein": { "type": "string" },
"ldr_sales_tax": { "type": "object" }
},
"allOf": [
{
"if": {
"properties": {
"tax_accounts": { "contains": { "const": "sales_tax" } }
},
"required": ["tax_accounts"]
},
"then": { "required": ["ldr_sales_tax", "fein"] }
}
]
}
Entity type
Example:
"llc"
Jurisdiction (ISO 3166-2)
Example:
"US-NC"
Expedited processing tiers this jurisdiction offers, accepted as the expedited_tier value on the formation create endpoints. Empty array when the state offers no expedited option. Present only when a jurisdiction is supplied. For the cost of each tier, call GET /v1/filing/formation/fee — the expedited_tiers field prices them.
Example:
["24_hour", "same_day", "1_hour"]
Foreign qualification only: documents the target state needs alongside the application, each with whether it is always required and who supplies it. Empty when none have been captured for the state, which is not a claim that none are needed.
Show child attributes
Show child attributes
Foreign qualification only: signatures the state needs on the application.
Show child attributes
Show child attributes
Foreign qualification only: obligations the registration starts once accepted.
Show child attributes
Show child attributes
Foreign qualification only: how the state accepts the application. Mail filings take longer and offer no expedited processing. Null when not yet known for the state.
Available options:
online, mail, null Example:
"online"
Was this page helpful?