A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "<string>",
"status": "draft",
"numbers": [
{
"id": "<string>",
"e164": "<string>",
"status": "<string>",
"phoneType": "local",
"carrierName": "<string>",
"portable": true,
"notPortableReason": "<string>",
"portOrderId": "<string>",
"preassignAgentId": "<string>",
"landedDidId": "<string>",
"landedAt": "2023-11-07T05:31:56Z"
}
],
"orders": [
{
"id": "<string>",
"stage": "draft",
"focDate": "2023-11-07T05:31:56Z",
"supportKey": "<string>",
"carrierName": "<string>",
"actionNeeded": [
{
"code": "<string>",
"message": "<string>",
"fixField": "<string>"
}
]
}
],
"createdAt": "2023-11-07T05:31:56Z",
"focDate": "2023-11-07T05:31:56Z",
"signedAt": "2023-11-07T05:31:56Z",
"lastError": "<string>",
"comments": [
{
"body": "<string>",
"author": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"accountHolderType": "business",
"entityName": "<string>",
"authPersonName": "<string>",
"accountNumber": "<string>",
"btn": "<string>",
"streetAddress": "<string>",
"extendedAddress": "<string>",
"locality": "<string>",
"administrativeArea": "<string>",
"postalCode": "<string>",
"countryCode": "US",
"portType": "full",
"remainingNumbersAction": "keep",
"newBillingPhoneNumber": "<string>",
"losingCarrier": "<string>",
"billFileId": "<string>",
"e911SameAsService": true,
"e911Street": "<string>",
"e911Extended": "<string>",
"e911Locality": "<string>",
"e911AdministrativeArea": "<string>",
"e911PostalCode": "<string>",
"focRequestedAt": "2023-11-07T05:31:56Z"
},
"message": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Edit a port-in request
Edit a request. In draft all account fields and the numbers list are editable; in action_needed only the account fields are editable (the numbers are frozen). Any other state rejects the edit.
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "<string>",
"status": "draft",
"numbers": [
{
"id": "<string>",
"e164": "<string>",
"status": "<string>",
"phoneType": "local",
"carrierName": "<string>",
"portable": true,
"notPortableReason": "<string>",
"portOrderId": "<string>",
"preassignAgentId": "<string>",
"landedDidId": "<string>",
"landedAt": "2023-11-07T05:31:56Z"
}
],
"orders": [
{
"id": "<string>",
"stage": "draft",
"focDate": "2023-11-07T05:31:56Z",
"supportKey": "<string>",
"carrierName": "<string>",
"actionNeeded": [
{
"code": "<string>",
"message": "<string>",
"fixField": "<string>"
}
]
}
],
"createdAt": "2023-11-07T05:31:56Z",
"focDate": "2023-11-07T05:31:56Z",
"signedAt": "2023-11-07T05:31:56Z",
"lastError": "<string>",
"comments": [
{
"body": "<string>",
"author": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"accountHolderType": "business",
"entityName": "<string>",
"authPersonName": "<string>",
"accountNumber": "<string>",
"btn": "<string>",
"streetAddress": "<string>",
"extendedAddress": "<string>",
"locality": "<string>",
"administrativeArea": "<string>",
"postalCode": "<string>",
"countryCode": "US",
"portType": "full",
"remainingNumbersAction": "keep",
"newBillingPhoneNumber": "<string>",
"losingCarrier": "<string>",
"billFileId": "<string>",
"e911SameAsService": true,
"e911Street": "<string>",
"e911Extended": "<string>",
"e911Locality": "<string>",
"e911AdministrativeArea": "<string>",
"e911PostalCode": "<string>",
"focRequestedAt": "2023-11-07T05:31:56Z"
},
"message": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
Path Parameters
Body
The tenant-editable account holder, service address, E911, and port-type fields. Shared by the create and update requests and echoed (minus pinPasscode) on the request detail. All optional at the wire — completeness is enforced at submit.
business, individual The person/company on the current-carrier account.
The person authorizing the port (the LOA signer).
The account number with the current carrier.
The billing telephone number on the account.
City.
State/province.
ISO 3166-1 alpha-2 (US or CA in this release).
US, CA full, partial For a partial port — what to do with the numbers left behind.
keep, disconnect Required when remainingNumbersAction is keep.
Object key of the uploaded recent bill/invoice.
When true the service address is the registered emergency address (the e911* fields are ignored).
Requested port date/time (ISO-8601). Omit for the earliest available.
The carrier port-out PIN. Write-only — never returned.
Editable only while the request is a draft.
Show child attributes
Show child attributes
Response
The updated request.
The tenant-editable account holder, service address, E911, and port-type fields. Shared by the create and update requests and echoed (minus pinPasscode) on the request detail. All optional at the wire — completeness is enforced at submit.
Show child attributes
Show child attributes
Show child attributes
Show child attributes