Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Accounts

Create account application

Create a new account application.

If submit is set to false:

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:

  • Either the personal object or company object is REQUIRED. Pass one or the other but not both.
  • This endpoint creates a default entity object for the account owner based on document ID.

Refer to the Core objects and the Accounts guides for more information.

post/acquisitions/v3/s2s/applications

Request body

Example request

{
  "application": {
    "submit": true,
    "applicant": {
      "document_number": "12345678910",
      "birth_date": "1991-11-27",
      "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
        }
      ],
      "phones": [
        {
          "phone": "11912345678",
          "phone_type": "MOBILE",
          "country_code": "555",
          "area_code": 11,
          "extension": "ext. 9"
        }
      ]
    },
    "acquisition_channel": 111,
    "program_id": 492,
    "due_date": 222,
    "program_calendar_strategy_id": 8675309
  }
}

Response

Created

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
}