Class: Increase::Resources::Entities

Inherits:
Object
  • Object
show all
Defined in:
lib/increase/resources/entities.rb

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ Entities

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Entities.

Parameters:



324
325
326
 
# File 'lib/increase/resources/entities.rb', line 324

def initialize(client:)
  @client = client
end

Instance Method Details

#archive(entity_id, request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityArchiveParams for more details.

Archive an Entity

Parameters:

  • entity_id (String) —

    The identifier of the Entity to archive. Any accounts associated with an entity

  • request_options (Increase::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



146
147
148
149
150
151
152
153
 
# File 'lib/increase/resources/entities.rb', line 146

def archive(entity_id, params = {})
  @client.request(
    method: :post,
    path: ["entities/%1$s/archive", entity_id],
    model: Increase::Entity,
    options: params[:request_options]
  )
end

#archive_beneficial_owner(entity_id, beneficial_owner_id: , request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityArchiveBeneficialOwnerParams for more details.

Archive a beneficial owner for a corporate Entity

Parameters:

  • entity_id (String) —

    The identifier of the Entity associated with the Beneficial Owner that is being

  • beneficial_owner_id (String) —

    The identifying details of anyone controlling or owning 25% or more of the corpo

  • request_options (Increase::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



171
172
173
174
175
176
177
178
179
180
 
# File 'lib/increase/resources/entities.rb', line 171

def archive_beneficial_owner(entity_id, params)
  parsed, options = Increase::EntityArchiveBeneficialOwnerParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["entities/%1$s/archive_beneficial_owner", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#confirm(entity_id, confirmed_at: nil, request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityConfirmParams for more details.

Depending on your program, you may be required to re-confirm an Entity’s details on a recurring basis. After making any required updates, call this endpoint to record that your user confirmed their details.

Parameters:

  • entity_id (String) —

    The identifier of the Entity to confirm the details of.

  • confirmed_at (Time) —

    When your user confirmed the Entity’s details. If not provided, the current time

  • request_options (Increase::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



200
201
202
203
204
205
206
207
208
209
 
# File 'lib/increase/resources/entities.rb', line 200

def confirm(entity_id, params = {})
  parsed, options = Increase::EntityConfirmParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["entities/%1$s/confirm", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#create(structure: , corporation: nil, description: nil, government_authority: nil, joint: nil, natural_person: nil, risk_rating: nil, supplemental_documents: nil, third_party_verification: nil, trust: nil, request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityCreateParams for more details.

Create an Entity

Parameters:

Returns:

See Also:



38
39
40
41
42
43
44
45
46
47
 
# File 'lib/increase/resources/entities.rb', line 38

def create(params)
  parsed, options = Increase::EntityCreateParams.dump_request(params)
  @client.request(
    method: :post,
    path: "entities",
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#create_beneficial_owner(entity_id, beneficial_owner: , request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityCreateBeneficialOwnerParams for more details.

Create a beneficial owner for a corporate Entity

Parameters:

Returns:

See Also:



227
228
229
230
231
232
233
234
235
236
 
# File 'lib/increase/resources/entities.rb', line 227

def create_beneficial_owner(entity_id, params)
  parsed, options = Increase::EntityCreateBeneficialOwnerParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["entities/%1$s/create_beneficial_owner", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#list(created_at: nil, cursor: nil, idempotency_key: nil, limit: nil, status: nil, request_options: {}) ⇒ Increase::Internal::Page<Increase::Models::Entity>

Some parameter documentations has been truncated, see Models::EntityListParams for more details.

List Entities

Parameters:

Returns:

See Also:



120
121
122
123
124
125
126
127
128
129
130
 
# File 'lib/increase/resources/entities.rb', line 120

def list(params = {})
  parsed, options = Increase::EntityListParams.dump_request(params)
  @client.request(
    method: :get,
    path: "entities",
    query: parsed,
    page: Increase::Internal::Page,
    model: Increase::Entity,
    options: options
  )
end

#retrieve(entity_id, request_options: {}) ⇒ Increase::Models::Entity

Retrieve an Entity

Parameters:

  • entity_id (String) —

    The identifier of the Entity to retrieve.

  • request_options (Increase::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



60
61
62
63
64
65
66
67
 
# File 'lib/increase/resources/entities.rb', line 60

def retrieve(entity_id, params = {})
  @client.request(
    method: :get,
    path: ["entities/%1$s", entity_id],
    model: Increase::Entity,
    options: params[:request_options]
  )
end

#update(entity_id, risk_rating: nil, third_party_verification: nil, request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityUpdateParams for more details.

Update an Entity

Parameters:

Returns:

See Also:



87
88
89
90
91
92
93
94
95
96
 
# File 'lib/increase/resources/entities.rb', line 87

def update(entity_id, params = {})
  parsed, options = Increase::EntityUpdateParams.dump_request(params)
  @client.request(
    method: :patch,
    path: ["entities/%1$s", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#update_address(entity_id, address: , request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityUpdateAddressParams for more details.

Update a Natural Person or Corporation’s address

Parameters:

Returns:

See Also:



254
255
256
257
258
259
260
261
262
263
 
# File 'lib/increase/resources/entities.rb', line 254

def update_address(entity_id, params)
  parsed, options = Increase::EntityUpdateAddressParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["entities/%1$s/update_address", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#update_beneficial_owner_address(entity_id, address: , beneficial_owner_id: , request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityUpdateBeneficialOwnerAddressParams for more details.

Update the address for a beneficial owner belonging to a corporate Entity

Parameters:

Returns:

See Also:



283
284
285
286
287
288
289
290
291
292
 
# File 'lib/increase/resources/entities.rb', line 283

def update_beneficial_owner_address(entity_id, params)
  parsed, options = Increase::EntityUpdateBeneficialOwnerAddressParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["entities/%1$s/update_beneficial_owner_address", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end

#update_industry_code(entity_id, industry_code: , request_options: {}) ⇒ Increase::Models::Entity

Some parameter documentations has been truncated, see Models::EntityUpdateIndustryCodeParams for more details.

Update the industry code for a corporate Entity

Parameters:

  • entity_id (String) —

    The identifier of the Entity to update. This endpoint only accepts ‘corporation`

  • industry_code (String) —

    The North American Industry Classification System (NAICS) code for the corporati

  • request_options (Increase::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



310
311
312
313
314
315
316
317
318
319
 
# File 'lib/increase/resources/entities.rb', line 310

def update_industry_code(entity_id, params)
  parsed, options = Increase::EntityUpdateIndustryCodeParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["entities/%1$s/update_industry_code", entity_id],
    body: parsed,
    model: Increase::Entity,
    options: options
  )
end