v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Accounts

Update account application

Update a previously-created account application, only if the account application's submit field is false.

If submit is set to false:

The application is not sent for processing and can be further modified with incremental changes via this endpoint.

If submit flag is set to true:

No further updates can be made and the account application is sent out for processing, which creates an account and its associated structures.
This endpoint generates an Account application created event.

Warning—Some of the account's elements are created asynchronously and you should refrain from accessing the account via other endpoints until the events this endpoint generates are received.

Notes:

By default, prospect_cancel is false. If you set prospect_cancel to true, the account application is canceled and no further updates can be made.
You cannot update a previously-entered address. All addresses entered are considered new. The main address is the last one passed with mailing_address = true.
You cannot update a previously-entered partner object. All partner information entered is considered new.
For all other objects and fields, anything not passed is not updated.

patch/acquisitions/v2/s2s/applications/{applicationId}

Path parameters

applicationIdinteger required

Example:12345

Application ID

Request body

Example request

{
  "application": {
    "submit": true,
    "prospect_cancel": true,
    "applicant": {
      "document_number": "12345678910",
      "birth_date": "31/12/1980",
      "personal": {
        "external_id": "8c8a4dd7-e48f-4c15-85b7-9d12f401057f",
        "name": "Hyman Roth",
        "email": "jenna.flect@email.com",
        "gender": "M",
        "printed_name": "John Doe",
        "nickname": "Pinto",
        "social_name": "Terminator",
        "country_of_birth": "India",
        "state_of_birth": "California",
        "city_of_birth": "San Diego",
        "registration": {
          "number": "1234567890"
        },
        "marital_status": "MARRIED",
        "fathers_name": "Steven Douglas",
        "mothers_name": "Kay Sadilla",
        "nationality": "Australian",
        "other_id_number": "29000000",
        "document_issued_at": "Brazil",
        "document_issued_date": "01/31/1970",
        "occupation": "Creative Accountant",
        "assets": 40000,
        "income": 4000,
        "net_worth": 20000
      },
      "company": {
        "external_id": "8c8a4dd7-e48f-4c15-85b7-9d12f401057f",
        "name": "Acme Inc.",
        "email": "acme@acmemail.com",
        "company_name": "Acme General Products",
        "registration_number": "ACM10004",
        "activity": "Manufacturing",
        "company_type": "Retailer",
        "company_format": "ME",
        "company_constitution_date": "2004-01-20",
        "occupation": "Online retail",
        "income": 10000,
        "net_worth": 20000,
        "annual_revenues": 33000,
        "type": "B2C",
        "number_of_partners": 3,
        "perc_ownership": 50,
        "fiscal_situation": "Good",
        "debt": 18000,
        "partners": [
          {
            "name": "Hyman Roth",
            "nickname": "Pinto",
            "printed_name": "Sarah Toga",
            "social_name": "Jack",
            "email": "jenna.flect@email.com",
            "document_number": "7777888hh",
            "mothers_name": "Kay Sadilla",
            "gender": "M",
            "birth_date": "31/12/1980",
            "city_of_birth": "San Diego",
            "state_of_birth": "California",
            "country_of_birth": "India",
            "fathers_name": "Steven Douglas",
            "marital_status": "MARRIED"
          }
        ]
      },
      "account": {
        "currency_numeric_code": "840",
        "granted_limit": 1500,
        "limit": 750,
        "exchange_mode": "SAME_DAY",
        "external_id": "8c8a4dd7-e48f-4c15-85b7-9d12f401057f",
        "parent_account_id": 232,
        "overdraft_limit": 123.45,
        "account_type": "TRAN",
        "division_id": "6f8a456a-8b1a-4022-a2f8-7612595330b5"
      },
      "addresses": [
        {
          "address": {
            "line1": "1313 Mockingbird Lane",
            "line2": "Apt 4B",
            "country": "USA",
            "country_subdivision": "CA",
            "city": "San Francisco",
            "postal_code": "8675309"
          },
          "city": "San Diego",
          "state": "California",
          "country": "Brazil",
          "address_type": "RESIDENTIAL",
          "zip_code": "12345-678",
          "neighborhood": "Shady Pines",
          "complementary_address": "Apt 1408",
          "mailing_address": true
        }
      ]
    }
  }
}

Response

application_idinteger required

Application form ID (non-checking accounts only)

statusinteger required

Application status ID

status_namestring required

Application status. Most likely to be

REGISTERED - Application was saved, but not started processing yet.
APPROVED - Application has finished processing.
PROSPECT - Application was created with submit = false.

account_idinteger required

Created account ID. null if the application has not been proccessed yet (non-checking accounts only).

customer_idinteger required

Created customer ID. null if the application has not yet been proccessed (non-checking accounts only).

entity_idinteger required

Created entity ID. null if the application has not yet been proccessed (non-checking accounts only).

program_idnumber required

Pismo program ID.

Example response

{
  "application_id": 1234,
  "status": 4,
  "status_name": "APPROVED",
  "account_id": 123,
  "customer_id": 123,
  "entity_id": 123,
  "program_id": 1010
}