# Namingo Registry EPP Server The **Namingo EPP Server** provides a robust and standards-compliant interface for managing domain registrations, hosts, and contacts via the **Extensible Provisioning Protocol (EPP)**. This section offers practical examples of commonly used EPP commands, showcasing request and response structures for seamless integration with the Namingo Registry. ## Overview EPP is an XML-based protocol designed for secure communication between registrars and registries. The Namingo EPP Server adheres to **RFC 5730-5734** and relevant extensions to support modern domain management operations, including: - **Session Management**: Login, logout, and keep-alive commands - **Domain Management**: Create, update, renew, transfer, delete, and check domain availability - **Host (Nameserver) Management**: Create, update, delete, and query hosts - **Contact Management**: Create, update, delete, and retrieve contact information - **Poll Mechanism**: Retrieve registry notifications (e.g., transfer approvals, policy updates) Each command section below includes real-world XML request and response samples to facilitate easy integration. --- ## Commands ### 1. Session #### 1.1. Login **Request:** ```xml username password 1.0 en urn:ietf:params:xml:ns:domain-1.0 urn:ietf:params:xml:ns:contact-1.0 urn:ietf:params:xml:ns:host-1.0 urn:ietf:params:xml:ns:secDNS-1.1 urn:ietf:params:xml:ns:rgp-1.0 urn:ietf:params:xml:ns:launch-1.0 urn:ietf:params:xml:ns:idn-1.0 urn:ietf:params:xml:ns:epp:fee-1.0 https://namingo.org/epp/funds-1.0 https://namingo.org/epp/identica-1.0 client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 1.2. Logout **Request:** ```xml client-20241128-12345 ``` **Response:** ```xml Command completed successfully; ending session client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 1.3. Hello **Request:** ```xml ``` #### 1.4. Poll **Request:** ```xml client-20241128-12345 ``` **Response without message:** ```xml Command completed successfully; no messages client-20241128-12345 namingo-1234567890-abcdef1234 ``` **Response with message:** ```xml Command completed successfully; ack to dequeue 2025-02-03T11:17:38.014Z Transfer requested. test8.test pending nordregistrar 2025-02-03T11:17:38.013Z leonet 2025-02-08T11:17:38.013Z 2027-12-06T11:19:20.343Z client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 1.5. Poll Acknowledge **Request:** ```xml client-20241128-12345 ``` **Response:** ```xml Command completed successfully; no messages client-20241128-12345 namingo-1234567890-abcdef1234 ``` ### 2. Contact #### 2.1. Contact Check **Request:** ```xml abc-56789 client-20241128-12345 ``` **Response:** ```xml Command completed successfully abc-56789 client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 2.2. Contact Create **Standard request:** ```xml abc-56789 Ivan Ivanenko LLC "Prykladna Orhanizatsiya" Shevchenka St, 10 Office 5 Kyiv Kyivska oblast 01001 UA +380.441234567 +380.442345678 example@domain.ua D0main$ecret42 client-20241128-12345 ``` **Standard Response:** ```xml Command completed successfully MRG67507ad83de49 2024-12-04T15:52:56.264Z client-20241128-12345 namingo-1234567890-abcdef1234 ``` **Request with Identica extension:** ```xml abc-56789 Ivan Ivanenko LLC "Prykladna Orhanizatsiya" Shevchenka St, 10 Office 5 Kyiv Kyivska oblast 01001 UA +380.441234567 +380.442345678 example@domain.ua D0main$ecret42 1234567890 client-20241128-12345 ``` #### 2.3. Contact Info **Request:** ```xml abc-56789 client-20241128-12345 ``` **Response:** ```xml Command completed successfully abc-56789 C1 John A. Doe EXAMPLE CORP 123 Main Street, Business District Metropolis CA 90210 US +1.5551234567 john.doe@example.com leonet leonet 2024-12-03T10:39:22.453Z leonet 2024-12-06T11:55:56.934Z EeF8eT77c7YpD2w0 client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 2.4. Contact Update **Standard request:** ```xml abc-12345 Petro Petrenko LLC "Nova Orhanizatsiya" Hrushevskoho St, 15 Building B Suite 12 Odesa Odeska oblast 65000 UA +380.482123456 +380.482654321 example@newdomain.ua client-20241128-12345 ``` **Request with Identica extension:** ```xml abc-12345 Petro Petrenko LLC "Nova Orhanizatsiya" Hrushevskoho St, 15 Building B Suite 12 Odesa Odeska oblast 65000 UA +380.482123456 +380.482654321 example@newdomain.ua 1234567890 client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 2.5. Contact Delete **Request:** ```xml abc-12398 client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` ### 3. Host #### 3.1. Host Check **Request:** ```xml ns1.example.test client-20241128-12345 ``` **Response:** ```xml Command completed successfully ns1.example.test client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 3.2. Host Create **Request:** ```xml ns1.example.test 192.0.2.1 client-20241128-12345 ``` **Response:** ```xml Command completed successfully ns1.example.test 2024-12-04T16:03:26.818Z client-20241128-12345 namingo-1733328206-58daa6da62 ``` #### 3.3. Host Info **Request:** ```xml ns1.example.test client-20241128-12345 ``` **Response:** ```xml Command completed successfully ns1.example.test H6 leonet leonet 2024-12-04T16:05:08.251Z client-20241128-12345 namingo-1733328206-58daa6da62 ``` #### 3.4. Host Update **Request:** ```xml ns1.example.test 198.51.100.2 192.0.2.1 client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 3.5. Host Delete **Request:** ```xml ns2.example.test client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` ### 4. Domain #### 4.1. Domain Check **Standard request:** ```xml example.test example.example client-20241128-12345 ``` **Standard response:** ```xml Command completed successfully example.test example.example client-20241128-12345 namingo-1733327112-3911de7da6 ``` **Check for claims:** ```xml example.test example.example claims client-20241128-12345 ``` #### 4.2. Domain Create **Standard request:** ```xml myexample.test 1 ns1.example.example ns2.example.example abc-56789 abc-12345 abc-12345 abc-12345 D0main$ecret42 client-20241128-12345 ``` **Standard response:** ```xml Command completed successfully myexample.test 2024-12-04T16:06:44.813Z 2025-12-04T16:06:44.813Z client-20241128-12345 namingo-1733328404-9a15122064 ``` **Request with DNSSEC:** ```xml myexample.test 1 ns1.example.example ns2.example.example abc-56789 abc-12345 abc-12345 abc-12345 D0main$ecret42 12345 8 2 49FD46E6C4B45C55D4AC93CE4721E8C6DB6FAB1D 67890 13 2 3A5B4C2D75E3F58B907BD2318D3470FBC9038D40 client-20241128-12345 ``` **Request with claims:** ```xml myexample.test 1 ns1.example.example ns2.example.example abc-56789 abc-12345 abc-12345 abc-12345 D0main$ecret42 claims ABC-12345678-XYZ 2024-12-31T23:59:59Z 2024-11-28T14:30:00Z client-20241128-12345 ``` **Request for sunrise:** ```xml myexample.test 1 ns1.example.example ns2.example.example abc-56789 abc-12345 abc-12345 abc-12345 D0main$ecret42 sunrise PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHNnbTpzaWduZWRNYXJrIHhtbG5zOnNnbT0idXJuOmlldGY6cGFyYW1zOnhtbDpuczpzaWduZWRNYXJrLTEuMCI+CiAgPHNnbTp0bWNoSWRlbnRpdHk+RG9tYWluTmFtZS5jb208L3NnbTp0bWNoSWRlbnRpdHk+CiAgPHNnbTp0bWNoRGV0YWlscz4KICAgIDxzZ206dG1jaFN0YXR1cz5WYWxpZDwvc2dtOnRtY2hTdGF0dXM+CiAgPC9zZ206dG1jaERldGFpbHM+CiAgPHNnbTpzaWduYXR1cmU+CiAgICA8c2dtOnNpZ25hdHVyZU1ldGhvZD5yc2Etc2hhMjU2PC9zZ206c2lnbmF0dXJlTWV0aG9kPgogICAgPHNnbTpkaWdlc3Q+...base64encodeddata... client-20241128-12345 ``` #### 4.3. Domain Info **Standard request:** ```xml myexample.test authInfoPw client-20241128-12345 ``` **Standard response:** ```xml Command completed successfully myexample.test D3 abc-56789 abc-12345 abc-12345 abc-12345 ns1.example.example ns2.example.example leonet leonet 2024-12-04T16:06:44.813Z 2025-12-04T16:06:44.813Z authInfoPw client-20241128-12345 namingo-1733328536-2f53159160 ``` **Response with Identica in database:** ```xml ... 1234567890 ... ``` #### 4.4. Domain Update **Request:** ```xml myexample.test ns1.example.example bcd-92345 ns3.example.example bcd-92345 bcd-92345 D0main$ecret42 12345 8 2 49FD46E6C4B45C55D4AC 67890 8 2 23AB56C7D8EF9AB34A12 client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` #### 4.5. Domain Renew **Request:** ```xml myexample.test 2025-12-04 1 client-20241128-12345 ``` **Response:** ```xml Command completed successfully myexample.test 2026-12-04T16:06:44.813Z client-20241128-12345 namingo-1733328764-f74b50827f ``` #### 4.6. Domain Transfer **Request and Response:** ```xml myexample.test 1 D0main$ecret42 client-20241128-12345 ``` ```xml Command completed successfully; action pending myexample.test pending leonet 2025-02-07T11:01:51.829Z nordregistrar 2025-02-12T11:01:51.829Z 2028-12-03T10:39:34.432Z client-20241128-12345 namingo-1733328764-f74b50827f ``` **Query Request and Response:** ```xml myexample.test client-20241128-12345 ``` ```xml Command completed successfully myexample.test pending leonet 2025-02-07T11:01:51.829Z nordregistrar 2025-02-12T11:01:51.829Z 2028-12-03T10:39:34.432Z client-20241128-12345 namingo-1733328764-f74b50827f ``` **Approve Request and Response:** ```xml myexample.test client-20241128-12345 ``` ```xml Command completed successfully myexample.test clientApproved leonet 2025-02-07T11:01:51.829Z nordregistrar 2025-02-12T11:01:51.829Z 2028-12-03T10:39:34.432Z client-20241128-12345 namingo-1733328764-f74b50827f ``` **Cancel Request and Response:** ```xml myexample.test client-20241128-12345 ``` ```xml Command completed successfully myexample.test clientCancelled leonet 2025-02-07T11:01:51.829Z nordregistrar 2025-02-12T11:01:51.829Z 2028-12-03T10:39:34.432Z client-20241128-12345 namingo-1733328764-f74b50827f ``` **Reject Request and Response:** ```xml myexample.test client-20241128-12345 ``` ```xml Command completed successfully myexample.test clientRejected leonet 2025-02-07T11:01:51.829Z nordregistrar 2025-02-12T11:01:51.829Z 2028-12-03T10:39:34.432Z client-20241128-12345 namingo-1733328764-f74b50827f ``` #### 4.7. Domain Delete **Request:** ```xml myexample.test client-20241128-12345 ``` **Response:** ```xml Command completed successfully; action pending client-20241128-12345 namingo-1733328984-1bfc0e2455 ``` #### 4.8. Domain Restore **Request:** ```xml example.test client-20241128-12345 ``` **Report Request:** ```xml example.test Pre-delete registration data goes here. Both XML and free text are allowed. Post-restore registration data goes here. Both XML and free text are allowed. 2019-10-10T22:00:00.0Z 2019-10-20T22:00:00.0Z Registrant error. This registrar has not restored the Registered Name in order to assume the rights to use or sell the Registered Name for itself or for any third party. The information in this report is true to best of this registrars knowledge, and this registrar acknowledges that intentionally supplying false information in this report shall constitute an incurable material breach of the Registry-Registrar Agreement. Supporting information goes here. client-20241128-12345 ``` **Response:** ```xml Command completed successfully client-20241128-12345 namingo-1234567890-abcdef1234 ``` ### 5. Extensions #### 5.1. Funds Info **Request:** ```xml client-20241128-12345 ``` **Response:** ```xml Command completed successfully 100000.00 USD 100000.00 100000.00 500.00 client-20241128-12345 namingo-1234567890-abcdef1234 ```