Standard parameters
action = get_transfers_in
object = domain
attributes
Attributes
Parameters within the attributes associative array are described below.
|
Parameter name |
Obligation |
Definition/Value |
|
completed_from |
Optional |
Specify the start date for the search. Only domains transferred on or after the specified date are returned. Use the format YYYY-MM-DD. |
|
completed_to |
Optional |
Specify the end date for the search. Only domains transferred on or before the specified date are returned. Use the format YYYY-MM-DD. |
|
domain |
Optional |
Submit the domain name attribute only if you want to check if a particular domain has been transferred in. |
|
limit |
Optional |
The maximum number of domains to return per page, up to 40. |
|
losing_registrar |
Optional |
Search for transfers-in according to losing registrar. String and wildcards (*) accepted. |
|
order_id |
Optional |
ID number of the order. |
|
order_from |
Optional |
Specify a starting date, in the format YYYY-MM-DD from which to return orders. Can be used with the order_to parameter to specify a range within which to search. If not used with order_to, all orders from the order_from date onward are returned. |
|
order_to |
Optional |
Specify an end date, in the format YYYY-MM-DD, before which to return orders. Can be used with the attribute order_from parameter to specify a range within which to search. If not used with order_from, all orders up to the order_to date are returned. |
|
owner_confirm_from |
Optional |
Search for transferred-in domains according to the date from when the owner confirmed or denied the transfer. Can be used with the owner_confirm_to attribute to specify a range within which to search. Use the format YYYY-MM-DD. Note: The year specified cannot exceed 2030. |
|
owner_confirm_ip |
Optional |
The IP address from which the owner confirmed or denied the transfer-in request. |
|
owner_confirm_to |
Optional |
Search for transferred-in domains according to the date prior to when the owner confirmed or denied the transfer. Can be used with the owner_confirm_from attribute to specify a range within which to search. Use the format YYYY-MM-DD. Note: The year specified cannot exceed 2030. |
|
owner_request_from |
Optional |
Search for transferred domains according to the date when the email was been sent to the request_address. Can be used with the owner_request_to attribute to specify a range within which to search. If not used with owner_request_to, all domains from the owner_request_from date onward are returned. The year specified cannot exceed 2030; otherwise an error is returned. Use the format YYYY-MM-DD. |
|
owner_request_to |
Optional |
Search for transferred domains according to the date prior to which the email was been sent to the request_address. Can be used with the owner_request_from attribute to specify a range within which to search. If not used with owner_request_from, all domains ever transferred in prior to the owner_request_to date are returned. Use the format YYYY-MM-DD. Note: The year specified cannot exceed 2030; otherwise an error is returned. |
|
page |
Optional |
Determines which page to retrieve, using the page number. The page index starts at 0 (zero). |
|
request_address |
Optional |
The admin email address at the time of notification. Wildcards (*) accepted. |
|
status |
Optional |
Search for transferred domains by status. Allowed values are pending_owner, pending_registry, completed, or cancelled. Note: pending_admin has been deprecated. |
|
transfer_id |
Optional |
ID number of the transfer. |